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: "Bearer {credentials}"
  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

Maximum time to wait for the client to complete elicitation before the request fails. When omitted, no timeout is enforced and the binding waits indefinitely for elicitation to complete.

options.authorization

object as map of named object properties

Authorization by a named guard, used to validate inbound MCP requests. A request with no Authorization header is admitted as unauthorized, matching how an unauthenticated request reaches an unguarded route elsewhere in Zilla; a request whose Authorization header is present but does not match the credentials template, or whose extracted credentials the guard rejects, is rejected outright with a 401 response and a WWW-Authenticate challenge.

authorization:
  my_jwt_guard:
    credentials: "Bearer {credentials}"

authorization.credentials

string | Default: Bearer {credentials}

Template matched against the inbound Authorization header, extracting the captured value in place of the required {credentials} placeholder and passing it to the named guard to authorize the 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.