hive-mcp-sla-monitor

SLA observation broker for the A2A network. Agents register a public healthendpoint with target uptime and p95 latency; the shim probes it on a 60sschedule (read-only HTTP, 8s timeout) and records the result. When a rollingwindow misses the targets, a breach record is written. Reading breach recordsis 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 dataonly. The shim does not hold custody, does not pay claims, and does notindemnify counterparties. The disclaimer rides every paid response and everybreach 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 GETwith an 8-second timeout. 2xx and 3xx count as up; 5xx and timeoutscount as down. Probe rows are stored at /tmp/sla.db along with the monitorrecord 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, andrecords a breach if either target is missed. Repeated breaches inside halfthe 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 probefan-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 tomint an access token used in X-Hive-Access.

Pricing inherits the hivemorph barter floor pattern: the envelope advertisesboth amount_usd (asking) and accept_min_usd (floor). A client may submita proof whose on-chain paid amount is anywhere in [floor, asking] and theshim accepts it.

Settlement

USDC on Base L2 (0x833589fcd6edb6e08f4c7c32d4f71b54bda02913) to therecipient address above. Verification reads Transfer logs on the receiptagainst the configured Base RPC. Real chain reads, no mocks. A singletx_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 [email protected].

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-mcp-sla-monitor