Call your first tool

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"}'

const res = await fetch("https://mcp.datari.kr/mcp", {
  method: "POST",
  headers: {
    "x-api-key": process.env.DATA_BRIDGE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "tools/list",
  }),
});
console.log(await res.json());

import os, requests
r = requests.post(
    "https://mcp.datari.kr/mcp",
    headers={
        "x-api-key": os.environ["DATA_BRIDGE_API_KEY"],
        "Content-Type": "application/json",
    },
    json={"jsonrpc": "2.0", "id": 1, "method": "tools/list"},
)
print(r.json())

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.

Getting started

Guides

Concepts

Call your first tool

Prerequisites

1. List registered tools

2. Run a tool

3. Receive real-time events over SSE

Next steps

Connect to Claude

API Reference

​Prerequisites

​1. List registered tools

​2. Run a tool

​3. Receive real-time events over SSE

​Next steps

Connect to Claude

API Reference

Prerequisites

1. List registered tools

2. Run a tool

3. Receive real-time events over SSE

Next steps