mcp

The hub MCP endpoint (JSON-RPC 2.0, one message per request)

Same envelope as every per-door endpoint (64KB body cap, notifications → 202, protocol errors as JSON-RPC error on HTTP 200). Tool routing differs in exactly two ways: a sixth tool find { query } searches the live directory, and the five door tools take a door argument (handle or door id) resolved through the UNCHANGED per-door machinery — custody, approvals, mandates, payments, and rate buckets all scope to the resolved door, exactly as if the agent had knocked on the door's own URL. The hub is routing, never a bypass, and holds no credential.

post/agent/hub/mcp

Request

  • Base URL: https://api.bubblio.dev
  • URL: https://api.bubblio.dev/agent/hub/mcp
  • Auth: none declared

Request body

jsonrpc'2.0' required
method'initialize' | 'ping' | 'tools/list' | 'tools/call' required
paramsobject

For tools/call: { name, arguments }.

Response

JSON-RPC result — or a JSON-RPC error object for malformed/unknown requests.

jsonrpc'2.0' required
resultobject

For tools/call: MCP content — { content: [{ type: 'text', text }], isError? } where text is a JSON document (see QuoteAnswer / ConfirmAnswer / Receipt for the action tools). Tool FAILURES arrive here with isError: true, phrased for the calling model; JSON-RPC error is reserved for protocol problems.

Changes

No recorded changes to this operation across all 1 revision of this API.