mcp server

The mcp server 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: scope
  exit: mcp_client

Configuration (* required)

options

object

The server kind mcp specific options.

options:
  elicitation:
    callback: auth/callback

options.prompts

array of object

Local prompts, surfaced via prompts/list and served directly without dispatching to an upstream.

options:
  prompts:
    - name: greeting
      description: A friendly greeting prompt

prompts[].name*

string

Prompt name.

prompts[].description

string

Prompt description.

options.elicitation

object

Elicitation configuration for the OAuth authorization flow.

elicitation.callback

string | Default: auth/callback

Path on which the binding receives the authorization callback during elicitation.

options.authorization

object

Authorization by a named guard.

authorization:
  name: my_jwt_guard

authorization.name*

string

Name of the guard used to authorize the MCP session.

routes

array of object

Conditional mcp specific routes.

routes[].when

array of object

List of conditions (any match) to match this route. Read more: When a route matches

when[].toolkit

string

Toolkit name to match. When omitted, every toolkit is admitted.

when[].capability

array of enum [ tools, prompts, resources ]

MCP capabilities to match.

routes[].with

object

Route with override configuration.

with.headers

object as map of named string properties

Request headers added when dispatching a matched request to this route's exit.

routes[].exit

string

Next binding when following this route.

routes:
  - exit: app1
    when:
      - toolkit: bluesky
        capability:
          - tools
  - exit: app2
    when:
      - toolkit: quartz

exit

string

Default exit binding when no conditional routes are viable.

exit: echo_server

telemetry

object

Defines the desired telemetry for the binding.

telemetry.metrics

array

Telemetry metrics to track

telemetry:
  metrics:
    - stream.*

telemetry.attributes

object as map of named string properties

Telemetry attributes to add to the binding metrics.