mcp-openapi Binding

Defines a binding reading OpenAPI specifications from a catalog and compiling routed operations — named individually or bulk-selected by spec, tag, or glob pattern — into a generated mcp-http proxy, exposing them as MCP tools and resources with a single spec parse and no protocol-specific code, with client or proxy behavior.

client

Full config

The client kind mcp-openapi binding originates the upstream http request for every compiled operation itself.

mcp_openapi_client:
  type: mcp-openapi
  kind: client
  options:
    specs:
      github:
        catalog:
          my_catalog:
            subject: github
            version: latest
        security:
          bearerAuth: my_guard
    tools:
      create_pr:
        description: Create a pull request to merge one branch into another.
  routes:
    - when:
        - tool: create_pr
      with:
        spec: github
        operation: create_pr
    - when:
        - resource: read_order
      with:
        spec: github
        operation: read_order
    - with:
        spec: github
        tag: issues

proxy

Full config

The proxy kind mcp-openapi binding compiles the same OpenAPI operations, but dispatches every request to a required exit instead of originating it directly.

mcp_openapi_proxy:
  type: mcp-openapi
  kind: proxy
  exit: http_client
  options:
    specs:
      github:
        catalog:
          my_catalog:
            subject: github
            version: latest
        security:
          bearerAuth: my_guard
    tools:
      create_pr:
        description: Create a pull request to merge one branch into another.
  routes:
    - when:
        - tool: create_pr
      with:
        spec: github
        operation: create_pr
    - when:
        - resource: read_order
      with:
        spec: github
        operation: read_order
    - with:
        spec: github
        tag: issues