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
    timeout: 30s

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.

elicitation.timeout

string | Default: PT0S

Maximum time to wait for the client to complete elicitation before the request fails.

options.authorization

object as map of named object properties

Authorization by a named guard.

authorization:
  my_jwt_guard:
    credentials: scope

authorization.credentials

string

Credentials used by the named guard to authorize the MCP session.

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.