AxMCPClientOptions
Defined in: https://github.com/ax-llm/ax/blob/7965c876f6a5b641e0cf166e8942e540cfde65e1/src/ax/mcp/client.ts#L160
Properties
| Property | Type | Description |
|---|---|---|
authorizeToolCall? | (call: Readonly<{ arguments: unknown; client: AxMCPClient; namespace: string; tool: AxMCPTool; }>) => undefined | boolean | Promise<undefined | boolean> | Host policy hook invoked before an MCP tool is called. |
capabilities? | AxMCPClientCapabilities | Extra client capabilities to advertise. Advertise only implemented ones. |
clientInfo? | Partial<AxMCPImplementationInfo> | Client metadata sent in initialize. |
debug? | boolean | Enable debug logging |
elicitation? | (params: Readonly<AxMCPElicitationCreateParams>, context: Readonly<{ client: AxMCPClient; namespace: string; }>) => | AxMCPElicitationCreateResult | Promise<AxMCPElicitationCreateResult> | Handles server-initiated elicitation/create requests. |
era? | "auto" | AxMCPEra | Protocol era selection. Auto-detection is the default. |
eraStore? | AxMCPEraStore | Optional persistence for origin-scoped automatic era detection. |
extensions? | Record<string, AxMCPExtensionCapability> | Optional MCP extensions advertised during initialize. |
functionOverrides? | AxMCPFunctionOverride[] | List of function overrides for tool/prompt/resource wrappers. |
logger? | AxLoggerFunction | Logger function for debug output |
logLevel? | AxMCPLoggingLevel | Default modern per-request logging level. |
maxConcurrency? | number | Maximum concurrent tool or task-augmented tool calls for this server. |
maxInputRounds? | number | Maximum MCP 2026-07-28 multi round-trip input rounds. Defaults to 5. |
maxPaginationPages? | number | Maximum pages accepted from any single catalog listing. |
namespace? | string | Stable namespace used when this client is attached to Ax programs. |
onLoggingMessage? | (params: Readonly<Record<string, unknown>>) => void | Promise<void> | - |
onNotification? | (notification: Readonly<AxMCPJSONRPCNotification>) => void | Promise<void> | Generic notification callback for all server notifications. |
onProgress? | (params: Readonly<AxMCPProgressNotificationParams>) => void | Promise<void> | - |
onPromptsChanged? | () => void | Promise<void> | - |
onResourcesChanged? | () => void | Promise<void> | - |
onResourceUpdated? | (uri: string) => void | Promise<void> | - |
onTaskStatus? | (task: Readonly<AxMCPTask>) => void | Promise<void> | - |
onToolsChanged? | () => void | Promise<void> | - |
protocolVersion? | string | MCP protocol version to request during initialize. Defaults to latest. |
readCache? | boolean | Enables TTL-aware caching for modern resources/read results. |
roots? | readonly AxMCPRoot[] | Optional roots support. When set, Ax advertises and answers roots/list. |
sampling? | (params: Readonly<AxMCPSamplingCreateMessageParams>, context: Readonly<{ client: AxMCPClient; namespace: string; }>) => | AxMCPSamplingCreateMessageResult | Promise<AxMCPSamplingCreateMessageResult> | Handles server-initiated sampling/createMessage requests. |
sessionRecovery? | "none" | "safe" | Reinitialize expired HTTP sessions for safe requests. Defaults to safe. |
supportedProtocolVersions? | readonly string[] | Protocol versions this client can accept during negotiation. |
tasksExtension? | boolean | Advertise the modern Tasks v2 extension. Defaults to true. |
tracer? | Tracer | Optional protocol tracer; request spans contain sanitized MCP metadata. |