GET /mcp/sse - Bridger

/mcp/sse is an SSE endpoint that delivers tool-execution results from the Gateway in real time. It’s used for dashboard live views, multi-client collaboration, and external observability integrations.

Request

GET /mcp/sse HTTP/1.1
Accept: text/event-stream
x-api-key: dk_live_...

Event types

`event: ready`

Emitted once right after connecting. Identifiable later via clientId (sse_ prefix).

event: ready
data: {"ok":true,"clientId":"sse_3f2a1c9b-..."}

Heartbeat

An SSE comment (: keepalive) is sent periodically to prevent NAT/proxy timeouts.

: keepalive

`event: message` — `gateway/toolResult`

The tools/call result is delivered only to the relevant client (tenant). It is not broadcast to everyone, in order to prevent cross-tenant data leakage. To target a client, pass _clientId along with the tools/call.

event: message
data: {
  "jsonrpc": "2.0",
  "method": "gateway/toolResult",
  "params": {
    "tool": "getultrashortcast",
    "upstream": {
      "method": "GET",
      "url": "https://apis.data.go.kr/...",
      "status": 200
    }
  }
}

`event: byoapi`

The progress of a BYOAPI registration job is delivered to the client that requested the registration.

event: byoapi
data: {"jobId":"...","status":"registered","job":{ ... }}

cURL

curl -N https://mcp.datari.kr/mcp/sse \
  -H "x-api-key: $DATA_BRIDGE_API_KEY" \
  -H "Accept: text/event-stream"

The -N (—no-buffer) flag gives you real-time output.

Node.js (EventSource)

import EventSource from "eventsource";

const es = new EventSource("https://mcp.datari.kr/mcp/sse", {
  headers: { "x-api-key": process.env.DATA_BRIDGE_API_KEY },
});

es.addEventListener("ready", (e) => {
  console.log("connected", JSON.parse(e.data));
});

es.addEventListener("message", (e) => {
  const ev = JSON.parse(e.data);
  if (ev.method === "gateway/toolResult") {
    console.log("tool result", ev.params);
  }
});

Operational notes

Events are delivered only to the connected client (tenant) and never leak to other tenants.
On 5xx errors, use EventSource or an equivalent library so the client reconnects automatically.

​Request

​Event types

​event: ready

​Heartbeat

​event: message — gateway/toolResult

​event: byoapi

​cURL

​Node.js (EventSource)

​Operational notes