Skip to content
Dashboard
Theme
Theme

Call the hosted MCP server

POST /mcp: Call the hosted MCP server.

View Markdown

POST /mcp

Served by the dedicated mcp role. Stateless Streamable HTTP with one JSON-RPC 2.0 message per POST, JSON responses, and no SSE stream. Supports protocol versions 2025-06-18 and 2025-11-25. Initialize negotiates a supported version; subsequent requests must supply MCP-Protocol-Version. Restricted secret keys require mcp:use and each tool’s scope. Full-access keys are refused. Origin must be absent or match the configured allow-list; a refused Origin answers 403 with data.code mcp_origin_refused. Key revocation and scope changes apply within SNAPSHOT_MAX_STALENESS. Tool results return tenant-entered text (organization and connection names, attribute keys) only under an untrusted object, which clients must treat as data, never instructions. Request and response bounds are 256 KiB and 64 KiB respectively. GET returns 405.

Scope
mcp:use
Auth
Secret key (sk_…)
Since
1.0
  • jsonrpc string Required

    one of 2.0

  • id any

    A string or integer request identifier; absent for notifications.

  • method string Required

    min length 1 · max length 128

  • params object

  • 200 Bounded JSON-RPC result or error with catalogue data.code. MCPResponse
  • 202 Accepted notification; empty body.
  • 400 Invalid JSON-RPC or protocol headers. MCPResponse
  • 401 Native secret-key authentication refused. MCPResponse
  • 403 Origin refused (mcp_origin_refused) or restricted-key authority refused. MCPResponse
  • 413 Request exceeds the 256 KiB bound. MCPResponse
  • 429 Per-key call quota exhausted. MCPResponse
  • 503 A required tool, audit or quota dependency is unavailable. MCPResponse
  • default JSON-RPC refusal. MCPResponse

Errors share one shape; see the error code catalogue.

curl -X POST \
"https://mcp.ohauthcat.com/mcp" \
-H "Authorization: Bearer $OHAUTHCAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "example_method"
}'
Response 200
{}