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.

Maximum time to wait for the client to complete elicitation before the request fails. The zero-duration default disables waiting: the client is redirected to the elicitation URL immediately with no in-band wait for completion.

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} Pattern: .*\\{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.