hive-mcp-sla-monitor
SLA observation broker for the A2A network. Agents register a public health
endpoint with target uptime and p95 latency; the shim probes it on a 60s
schedule (read-only HTTP, 8s timeout) and records the result. When a rolling
window misses the targets, a breach record is written. Reading breach records
is paid. Inbound only. ENABLE=true by default.
Brand color: #C08D23 (Pantone 1245 C, Hive Civilization gold).
Observation only
Hive does not underwrite or settle SLA claims. This is observational data only. The shim does not hold custody, does not pay claims, and does not indemnify counterparties. The disclaimer rides every paid response and every breach record.
Surface
| Layer | Endpoint | Description |
|---|---|---|
| MCP | POST /mcp | JSON-RPC 2.0, Streamable-HTTP, protocol 2024-11-05. |
| Discovery | GET /.well-known/mcp.json | Tool list and transport metadata. |
| REST | POST /v1/sla/register | Register an endpoint. 402 if no proof. |
| REST | GET /v1/sla/status/{id} | Read observed uptime and p95. 402 if no proof. |
| REST | GET /v1/sla/breaches?monitor_id=… | Read recent breach records. 402 if no proof. |
| REST | GET /v1/sla/today | UTC-day ledger snapshot. Free. |
| Health | GET /health | Liveness, pricing, recipient address. |
| Root | GET / | HTML for browsers, JSON for agents (Accept-header sniff). |
Tools
| Name | Tier | Cost | Description |
|---|---|---|---|
sla_register | 1 | $0.01/probe | Register a public endpoint for probing. |
sla_status | 1 | $0.01 | Read observed uptime and p95 over the rolling window. |
sla_breach_history | 2 | $0.10 | Read recent breach records. Disclaimer rides every record. |
sla_unregister | 0 | free | Deactivate a monitor. |
Probe semantics
The scheduler scans active monitors every 60 seconds and issues a GET
with an 8-second timeout. 2xx and 3xx count as up; 5xx and timeouts
count as down. Probe rows are stored at /tmp/sla.db along with the monitor
record and any breach records.
The breach evaluator runs after each probe. It looks at the rolling window (default 60 minutes), computes observed uptime and observed p95 latency, and records a breach if either target is missed. Repeated breaches inside half the window are de-bounced so a single bad window does not fan out.
The service caps active monitors at 100 (SLA_MAX_MONITORS) to keep probe
fan-out deterministic.
x402 envelope
Every paid endpoint returns a 402 envelope on first hit:
{
"error": "payment_required",
"x402_version": 1,
"disclaimer": "Hive does not underwrite or settle SLA claims. This is observational data only.",
"payment": {
"nonce": "…",
"amount_usd": 0.01,
"accept_min_usd": 0.007,
"accepts": [{
"chain": "base",
"asset": "USDC",
"contract": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"decimals": 6,
"recipient": "0x15184bf50b3d3f52b60434f8942b7d52f2eb436e",
"scheme": "exact"
}],
"tier": 1,
"product": "sla_register",
"floor_pct": 0.7
}
}
Submit the proof inline via X-Payment header on the retry, or POST it to
mint an access token used in X-Hive-Access.
Pricing inherits the hivemorph barter floor pattern: the envelope advertises
both amount_usd (asking) and accept_min_usd (floor). A client may submit
a proof whose on-chain paid amount is anywhere in [floor, asking] and the
shim accepts it.
Settlement
USDC on Base L2 (0x833589fcd6edb6e08f4c7c32d4f71b54bda02913) to the
recipient address above. Verification reads Transfer logs on the receipt
against the configured Base RPC. Real chain reads, no mocks. A single
tx_hash may only be redeemed once.
Environment
| Variable | Default | Notes |
|---|---|---|
PORT | 3000 | HTTP port. |
ENABLE | true | When false, only /health and / respond. |
WALLET_ADDRESS | 0x1518…436e | USDC recipient. |
SLA_REGISTER_PRICE_USDC | 0.01 | Per registration. |
SLA_BREACH_PRICE_USDC | 0.10 | Per breach-history read. |
SLA_STATUS_PRICE_USDC | 0.01 | Per status read. |
SLA_PROBE_INTERVAL_MS | 60000 | Probe loop interval. |
SLA_PROBE_TIMEOUT_MS | 8000 | Per-probe HTTP timeout. |
SLA_MAX_MONITORS | 100 | Active monitor cap. |
BASE_RPC_URL | https://mainnet.base.org | Base L2 JSON-RPC. |
SLA_DB_PATH | /tmp/sla.db | SQLite path. |
Run
npm install
npm start
# → http://localhost:3000/health
License
MIT. Author: Steve Rotzin steve@thehiveryiq.com.
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
<!-- /hive-footer -->