mcp Binding

Defines a binding with Model Context Protocol (MCP) support, with server, client, or proxy behavior.

server

Full config

The server kind mcp binding accepts inbound MCP client connections, handling authorization and elicitation before forwarding to the exit binding.

mcp_server:
  type: mcp
  kind: server
  options:
    elicitation:
      callback: auth/callback
    authorization:
      my_jwt_guard:
        credentials: "Bearer {credentials}"
  exit: mcp_client

client

Full config

The client kind mcp binding forwards outbound MCP requests to the upstream MCP server configured by its server URL.

mcp_client:
  type: mcp
  kind: client
  options:
    server: https://upstream.example.com/mcp
  exit: net_client

proxy

Full config

The proxy kind mcp binding routes inbound MCP requests to upstream MCP servers based on toolkit and per-route tool, prompt, and resource filters.

mcp_proxy:
  type: mcp
  kind: proxy
  options:
    cache:
      store: my_store
      ttl: 5m
  routes:
    - exit: app1
      when:
        - toolkit: bluesky
          tool:
            - post_*
    - exit: app2
      when:
        - toolkit: quartz