Hive Cdn

io.github.srotzinPublished by GitHub account srotzinv1.0.0Updated Oct 24, 2026

Edge content delivery for autonomous agents — signed manifests, A2A authentication

VerifiedStreamable HTTPWeb executableCloud & InfrastructureFiles & Storage

Overview

AI-generated overview

A remote edge cache for agent-to-agent objects: an assistant can store, read and purge keyed objects with ETag-aware reads, billed in USDC via x402.

What you can do
Store objects under a key, optionally with a cache TTL (free). Read cached objects by key, with ETag and If-None-Match support so unchanged content returns 304 without egress charges. Purge a single key idempotently. Check daily counters, pricing and service health through the REST endpoints.
When to use it
Useful when an agent pipeline reads the same agent cards, capability manifests or signed envelopes repeatedly and needs a shared edge cache with conditional GETs. Less relevant if you only need private storage, since keys are not access-controlled.
Requirements
Remote Streamable-HTTP endpoint; no local runtime or package. Reads require a prepaid access token obtained by submitting an on-chain USDC payment proof on Base L2, sent as the X-Hive-Access header. Network access to the endpoint.
Before you install
Reads cost money: $0.0002 per request plus $0.05 per GB egress, with a $1.00 prepay bundle settled in USDC on Base L2 to the configured wallet. Writes and purges are free and overwrite or delete cached data. Keys are not access-controlled, so do not store private material; the cache is not durable beyond its SQLite file.

Installation

In SourceWeft

  1. Open Hive Cdn in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.srotzin%2Fhive-mcp-cdn/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "hive-cdn": {
      "type": "http",
      "url": "https://hive-mcp-cdn.onrender.com/mcp"
    }
  }
}

README

hive-mcp-cdn

[srotzin/hive-mcp-cdn MCP server]

Edge cache for A2A capabilities — Hive Civilization

A small, inbound-only MCP server that caches arbitrary objects (agent cards, capability manifests, signed envelopes, anything an A2A pipeline reads more than once). Two-tier storage with an in-memory LRU and a SQLite warm tier, ETag and If-None-Match support, a purge endpoint, and per-request and per-GB metering through x402.

Council provenance: Ad-hoc, user-promoted 2026-04-27.


What this is

Most A2A traffic is reads — the same agent card, the same capability list, the same signed proof — fanned out across a fleet that has no shared cache. hive-mcp-cdn is the missing edge cache. Agents put objects under a key and fetch them back through a cheap, ETag-aware GET.

  • Protocol: MCP 2024-11-05 over Streamable-HTTP / JSON-RPC 2.0
  • Transport: POST /mcp
  • Discovery: GET /.well-known/mcp.json
  • Health: GET /health
  • Settlement: USDC on Base L2
  • Brand gold: Pantone 1245 C / #C08D23
  • Mode: Inbound only. ENABLE=true default.

Pricing

SurfacePriceCharged on
Per request$0.0002 USDCEvery /v1/cdn/get, hit or miss.
Per GB egress$0.05 USDCBody bytes returned in 200 responses. 304 responses do not bill egress.
Prepay bundle$1.00 USDCBuys an access token; reads draw from the prepaid balance until depletion.

Settlement on Base L2 USDC. The recipient is the WALLET_ADDRESS env var.

Tools

ToolTierDescription
cdn_cache_get2 ($0.0002/req + $0.05/GB)Read a cached object by key. Honors if_none_match.
cdn_cache_put0 (free)Store under a key with optional Cache-Control: max-age=....
cdn_purge0 (free)Purge a single key. Idempotent.

REST endpoints

MethodPathPurpose
GET/v1/cdn/get?key=...Read. Sends ETag, Cache-Control, X-Cache, Age. Honors If-None-Match.
POST/v1/cdn/putWrite { key, body, content_type?, cache_control? }.
POST/v1/cdn/purgePurge { key }.
GET/v1/cdn/todayDaily counters: requests, hits, misses, bytes served, revenue.
POST/v1/x402/proof/submitSubmit on-chain proof, mint access token.
GET/v1/x402/pricingPricing schedule.
GET/v1/x402/statsOpen nonces and active tokens.
GET/healthService health and cache stats.
GET/.well-known/mcp.jsonMCP discovery descriptor.
GET/Landing page.

Storage model

Two tiers, both managed by the shim:

  • Hot (LRU): an in-process Map with insertion-order recency. Bounded by CDN_LRU_MAX_ENTRIES and CDN_LRU_MAX_BYTES. Misses fall through to warm and promote on read.
  • Warm (SQLite): better-sqlite3 at CDN_DB_PATH (default /tmp/cdn.db). One cache table with body, ETag, content type, size in bytes, created and expiry timestamps. A second egress table aggregates daily counters.

size_bytes is tracked per row and is the basis for the egress meter. ETags are computed once at write time as the SHA-256 hex of the body, truncated to 32 chars and double-quoted.

x402 flow

The first call to /v1/cdn/get without a token returns:

json
{  "error": "payment_required",  "payment": {    "nonce": "<uuid>",    "amount_usd": 1.0,    "pricing": {      "per_request_usd": 0.0002,      "per_gb_egress_usd": 0.05    },    "accepts": [{ "chain": "base", "asset": "USDC", "recipient": "0x15184b..." }],    "expires_at": 1777220000,    "tier": 2,    "product": "cdn_prepaid_bundle"  }}

Submit proof to /v1/x402/proof/submit:

json
{ "nonce": "...", "payer": "0x...", "chain": "base", "tx_hash": "0x..." }

…then call /v1/cdn/get with X-Hive-Access: hive_<token>. Each request decrements the prepaid balance by per_request + (bytes / 1GB) * per_gb_egress. The residual balance rides the X-Hive-Balance-USD response header.

Cache semantics

  • Cache-Control: max-age=<s> on PUT sets the TTL. Default 300 seconds. Capped at 7 days.
  • ETag is a strong validator (SHA-256 prefix in quotes).
  • If-None-Match: <etag> on GET returns 304 Not Modified with no body and no egress charge.
  • Expired entries are dropped lazily on read and on a 60-second sweep.
  • A PUT over an existing key replaces the body, ETag, content type, TTL, and resets the hit counter.

Environment

VarDefaultPurpose
PORT3000HTTP port.
ENABLEtrueMaster switch. false runs /health only.
WALLET_ADDRESS0x15184bf50b3d3f52b60434f8942b7d52f2eb436eRecipient for x402 fees.
CDN_PRICE_PER_REQUEST_USD0.0002Per-request fee.
CDN_PRICE_PER_GB_EGRESS_USD0.05Per-GB egress fee.
CDN_PREPAY_BUNDLE_USD1.0Default prepay bundle size.
CDN_DEFAULT_TTL_S300Default TTL for objects without explicit max-age.
CDN_LRU_MAX_ENTRIES1024Hot-tier entry cap.
CDN_LRU_MAX_BYTES67108864Hot-tier byte cap (64 MiB).
CDN_MAX_OBJECT_BYTES4194304Per-object size limit (4 MiB).
CDN_DB_PATH/tmp/cdn.dbSQLite warm-tier path.

What this server will not do

  • Make outbound requests of any kind. The cache only holds what was put into it.
  • Resolve URLs, fetch origins, or revalidate against a backing store.
  • Enforce per-key access control. Treat keys as opaque namespaces and gate them upstream if you need privacy.
  • Persist beyond the SQLite file. On a fresh container with a new /tmp, the cache is empty.

License

MIT.

Hive Gamification

This MCP server is part of the Hive Civilization gamification surface (10-mechanic capability taxonomy).

Surface tags: gamification.spec.v1 · gamification.surface.public · gamification.signal.read-only · gamification.settlement.real-rails

Real rails on Base L2 (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913). Read-only signal layer. Brand gold #C08D23.

Hive Civilization Directory

Part of the Hive Civilization — agent-native financial infrastructure.

Brand: #C08D23

Source: README.md at commit b7ef8e8

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts