Skip to main content
This page shows what request returns what response right after you connect to the Bridger Gateway. Pick one tool and trace the input → output flow; from then on, you can call any tool with the same pattern.

Prerequisites

  • API key issued
  • Key stored in the DATA_BRIDGE_API_KEY environment variable
export DATA_BRIDGE_API_KEY="dk_live_..."

1. List registered tools

tools/list returns the metadata of every MCP tool loaded into Bridger (name, description, inputSchema).
curl -X POST https://mcp.datari.kr/mcp \
  -H "x-api-key: $DATA_BRIDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
The response includes tools with the following structure.
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "getultrashortcast",
        "description": "KMA ultra-short-term forecast — data.go.kr OpenAPI",
        "inputSchema": {
          "type": "object",
          "properties": {
            "searchKeyword": { "type": "string", "description": "Search keyword" },
            "pageNo": { "type": "integer", "description": "Page number" },
            "numOfRows": { "type": "integer", "description": "Results per page" }
          }
        }
      }
    ]
  }
}

2. Run a tool

Pick one tool and run it with tools/call. The example is an ultra-short-term forecast for Seoul.
curl -X POST https://mcp.datari.kr/mcp \
  -H "x-api-key: $DATA_BRIDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "getultrashortcast",
      "arguments": {
        "searchKeyword": "Seoul",
        "numOfRows": 10
      }
    }
  }'

3. Receive real-time events over SSE

For long-running tools or streaming responses, subscribe to the SSE endpoint (/mcp/sse).
curl -N https://mcp.datari.kr/mcp/sse \
  -H "x-api-key: $DATA_BRIDGE_API_KEY"
A gateway/toolResult event is delivered to your client for each tool execution.

Next steps

Connect to Claude

Let Claude call the same tools above in natural language.

API Reference

Full JSON-RPC and SSE spec, plus error codes.