Send an MCP JSON-RPC request

MCP

post /mcp

Accepts one opaque MCP JSON-RPC request over stateless Streamable HTTP. Use MCP discovery and tools rather than treating this as a REST operation.

Authentication

• McpBearer bearer token

  Send an AuthKit OAuth access token or Benchmark API key in the Authorization header.

Responses

• 200

  An MCP JSON-RPC response or tool result.

• 400

  The request failed validation.

• 401

  The MCP bearer credential is missing or invalid.

• 402

  The organization needs plan or purchased-credit entitlement, has reached its separate monthly spend cap, or cannot cover the operation within the entitled grace floor.

• 403

  The key cannot perform this operation.

• 404

  The resource was not found.

• 429

  The Cloudflare rate limiter rejected the request.

• 503

  A required service is unavailable.

Request

cURL

curl --request POST \
  --url "${BENCHMARK_API_BASE_URL}/mcp" \
  --header "Authorization: Bearer ${BENCHMARK_API_KEY}" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json, text/event-stream" \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"example-client","version":"1.0.0"}}}'

Response

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-11-25",
    "capabilities": {
      "tools": {}
    },
    "serverInfo": {
      "name": "benchmark",
      "version": "1.0.0"
    }
  }
}