POST /mcp (JSON-RPC)

The core MCP call endpoint of the Bridger Gateway. It follows the JSON-RPC 2.0 spec exactly.

Request headers

POST /mcp HTTP/1.1
Content-Type: application/json
x-api-key: dk_live_...

Common error codes

Code	Meaning
`-32600`	Invalid JSON-RPC request
`-32601`	Method not found
`-32602`	Invalid params (e.g. missing tool name)
`-32000`	Internal gateway error

tools/list

Returns tool metadata. A plain call returns the default profile — a shortlist of at most 40 tools made of search_tools, the most-used tools, and tools you enabled in the Dashboard. For the full catalog (230+ tools), append ?activation=all to the endpoint URL.

Full catalog (for developers)

POST https://mcp.bridger.kr/mcp?activation=all

The default profile keeps tool selection fast and accurate for MCP clients. Tools not in the list are still callable via tools/call, and search_tools finds them with natural-language search. Per-connector caps also apply — Gemini Enterprise (?connector=gemini or /mcp/gemini) exposes at most 100 actions.

Tool list change notification (`notifications/tools/list_changed`)

When you enable or disable tools in the Dashboard, a notifications/tools/list_changed JSON-RPC notification is pushed over the SSE stream (GET /mcp). Call tools/list again on receipt to refresh your tool list.

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Response 200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "pingtool",
        "description": "Ping endpoint",
        "inputSchema": { "type": "object", "properties": {} },
        "annotations": {
          "readOnlyHint": true,
          "destructiveHint": false,
          "openWorldHint": false
        }
      }
    ]
  }
}

tools/call

Runs a single tool.

Request

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "pingtool",
    "arguments": { "q": "hello" }
  }
}

Response 200

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "tool": "pingtool",
    "upstream": {
      "method": "GET",
      "url": "http://127.0.0.1:9921/ping?q=hello",
      "status": 200
    },
    "data": { "ok": true, "q": "hello" },
    "cacheStatus": "MISS",
    "auditId": "aud_..."
  }
}

Field	Description
`result.tool`	Called tool name
`result.upstream.method`	Upstream HTTP method
`result.upstream.url`	Final upstream URL (after middleware injection such as ServiceKey)
`result.upstream.status`	Upstream HTTP status code
`result.data`	Upstream response body (after XML→JSON normalization)
`result.cacheStatus`	Whether the cache was hit (`HIT`/`MISS`, etc.)
`result.auditId`	Audit-log identifier for this call

Full cURL examples

curl -X POST https://mcp.bridger.kr/mcp \
  -H "x-api-key: $BRIDGER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -X POST https://mcp.bridger.kr/mcp \
  -H "x-api-key: $BRIDGER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "pingtool",
      "arguments": { "q": "hello" }
    }
  }'

Automatic public-data middleware behavior

When calling a tool from a preset with isPublicData=true, the following are applied automatically.

ServiceKey injection (PUBLIC_DATA_SERVICE_KEY)
lat/lon → nx/ny grid coordinate conversion (KMA DFS)
XML/JSON payload normalization
Public-data error code → human-readable message mapping

Code	Message
`00`	OK
`30`	Unregistered service key
`31`	Expired service key
`32`	Unregistered IP
other	`Unknown public-data error (<code>)`

​Request headers

​Common error codes

​tools/list

​Tool list change notification (notifications/tools/list_changed)

​Request

​Response 200

​tools/call

​Request

​Response 200

​Full cURL examples

​Automatic public-data middleware behavior

Request headers

Common error codes

tools/list

Tool list change notification (`notifications/tools/list_changed`)

Request

Response 200

tools/call

Request

Response 200

Full cURL examples

Automatic public-data middleware behavior