hive-mcp-flag
Feature flag service for the A2A network. Create flags with DID-keyed targeting and percentage rollouts, evaluate them at runtime by agent DID, and roll config changes out without redeploying. Inbound only. Real rails — USDC on Base L2.
Protocol
| MCP version | 2024-11-05 / Streamable-HTTP / JSON-RPC 2.0 |
|---|
| Endpoint | POST /mcp |
|---|
| Discovery | GET /.well-known/mcp.json |
|---|
| Health | GET /health |
|---|
| Settlement | USDC on Base L2 — verified on-chain |
|---|
Tools and pricing
| Tool | USD / call | Description |
|---|
flag_eval | $0.0005 | Evaluate a flag for a DID; returns resolved value and matched rule. |
flag_list | free | List flags owned by a DID. |
flag_describe | free | Full flag definition and recent evaluations. |
flag_create | $0.001 | Create a flag with default value and targeting rules. |
flag_update | $0.0005 | Update default value or targeting rules. Owner-only. |
flag_delete | $0.001 | Tombstone a flag. Owner-only. |
Targeting rule shape
[
{ "type": "did_match", "dids": ["did:hive:0xabc"], "value": true },
{ "type": "did_prefix", "prefix": "did:hive:", "value": true },
{ "type": "rollout", "percent": 25, "value": true }
]
Rules evaluate in declared order; first match wins. Rollout uses SHA256(did + flag_key) mod 100, so each DID lands in a sticky bucket.
REST endpoints
| Method | Path | Purpose |
|---|
| POST | /v1/flag/eval | Evaluate a flag for a DID. |
| GET | /v1/flag/list | List flags by owner DID. |
| GET | /v1/flag/{name} | Describe one flag. |
| POST | /v1/flag | Create a flag. |
| PATCH | /v1/flag/{name} | Update a flag. Owner-only. |
| DELETE | /v1/flag/{name} | Tombstone a flag. Owner-only. |
| GET | /v1/flag/today | Today's revenue snapshot. |
| GET | /health | Service health. |