
Hive Cdn
io.github.srotzinPublished by GitHub account srotzinv1.0.0Updated Oct 24, 2026
Edge content delivery for autonomous agents — signed manifests, A2A authentication
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.
Installation
In SourceWeft
- Open Hive Cdn in the dashboard and add it to a workspace.
- 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.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=truedefault.
Pricing
Settlement on Base L2 USDC. The recipient is the WALLET_ADDRESS env var.
Tools
REST endpoints
Storage model
Two tiers, both managed by the shim:
- Hot (LRU): an in-process
Mapwith insertion-order recency. Bounded byCDN_LRU_MAX_ENTRIESandCDN_LRU_MAX_BYTES. Misses fall through to warm and promote on read. - Warm (SQLite):
better-sqlite3atCDN_DB_PATH(default/tmp/cdn.db). Onecachetable with body, ETag, content type, size in bytes, created and expiry timestamps. A secondegresstable 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:
Submit proof to /v1/x402/proof/submit:
…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>onPUTsets the TTL. Default300seconds. Capped at 7 days.- ETag is a strong validator (SHA-256 prefix in quotes).
If-None-Match: <etag>onGETreturns304 Not Modifiedwith no body and no egress charge.- Expired entries are dropped lazily on read and on a 60-second sweep.
- A
PUTover an existing key replaces the body, ETag, content type, TTL, and resets the hit counter.
Environment
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).
- Capability taxonomy: https://hive-gamification.onrender.com/.well-known/hive-gamification.json
- Centrifuge dashboard: https://hive-gamification.onrender.com/.well-known/hive-centrifuge.json
- Consolidated OpenAPI: https://hive-gamification.onrender.com/.well-known/openapi.json
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.
- Endpoint Directory: https://thehiveryiq.com
- Live Leaderboard: https://hive-a2amev.onrender.com/leaderboard
- Revenue Dashboard: https://hivemine-dashboard.onrender.com
- Other MCP Servers: https://github.com/srotzin?tab=repositories&q=hive-mcp
Brand: #C08D23
Source: README.md at commit b7ef8e8
Tools
0Version history
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