Skip to main content

JSON-RPC endpoint

Send POST requests to MCP root:
  • POST /mcp/ on API host
  • POST / on MCP host
GET and DELETE on MCP root return 405 Method Not Allowed.

Example: initialize

Example: list tools

Example: call capability tool

Approval-required MCP tool calls

If an MCP tool maps to a capability that requires approval, the tool returns a structured payload instead of executing immediately. Example result:
Clients should then call:
  • approvals_get
  • approvals_approve
  • approvals_reject

Example: list workspaces via MCP capability tool

Error behavior

  • Missing bearer token for protected method: JSON-RPC unauthorized error
  • Unknown tool name: JSON-RPC invalid params error
  • Capability execution failure: tool response includes error text
  • OAuth failures include WWW-Authenticate: Bearer ... challenge headers

Workspace currency

MCP capability execution resolves currency from the active workspace first, then falls back to the user profile, then usd.