Skip to main content
Bridger converts OpenAPI-based data sources into MCP tools and handles authentication, routing, and auditing in a single Gateway. Users call the Gateway endpoint without operating any servers of their own.

​
Components

Gateway

The execution layer that exposes MCP JSON-RPC, SSE, and the Registry API.

Tool Registry

Manages schemas, permissions, and routing for preset and BYOAPI-registered tools.

Public Data Adapter

Handles public-data service-key injection, coordinate conversion, XML/JSON normalization, and error mapping.

Admin Dashboard

Manages API keys, Provider Keys, and audit logs.

​
Runtime data flow

   Client (Claude · Cursor · ChatGPT · custom app)
        │
        │  MCP JSON-RPC / SSE / REST
        ▼
   ┌──────────────────────────────────────────────┐
   │            Bridger Gateway               │
   ├──────────────────────────────────────────────┤
   │  1. Authentication  (API Key / OAuth 2.0)     │
   │  2. Tenant isolation                           │
   │  3. Request control                            │
   │  4. JSON-RPC dispatch                          │
   │     ├─ tools/list → Registry lookup            │
   │     └─ tools/call → ID routing → Upstream Proxy│
   │  5. Public Data Adapter                        │
   │     ├─ ServiceKey auto-injection               │
   │     ├─ lat/lon → grid conversion               │
   │     └─ XML/JSON normalization                  │
   │  6. PII filtering                              │
   │  7. Audit logging                              │
   │  8. SSE event delivery (per tenant)            │
   └──────────────────────────────────────────────┘
        │
        ▼
   External APIs (data.go.kr · 3rd-party SaaS · self-registered APIs)

​
Preset structure

A preset is a tool definition that carries both an OpenAPI spec and public-data metadata. 
openapi: "3.0.3"
info:
  title: KMA Ultra-Short-Term Forecast API
  description: ...
  version: "1.0"
x-publicdata:
  provider: KMA
  dataGoKrId: "15070051"
servers:
  - url: https://apis.data.go.kr/...
paths:
  /getUltraSrtFcst:
    get:
      operationId: getUltraSrtFcst
      summary: Ultra-short-term forecast lookup
      parameters: [...]

​
Next steps

BYOAPI

How to register an arbitrary OpenAPI spec as a tool.

Auth & security

API keys, secrets, PII filtering, audit logs.