Skip to content

@tanstack/ai-mcp@0.9.0

Choose a tag to compare

@github-actions github-actions released this 13 Oct 17:48
· 192 commits to main since this release
Immutable release. Only release title and notes can be modified.
293aea9

Minor Changes

  • #1720 dce9fbe - createMCPClient({ requestOptions }) now also applies to the connect handshake. A server that does not answer while it connects fails after timeout, not after the SDK default of 60 seconds. If you set a short timeout for tool calls, a slow server can now fail at connect. On a stdio server, connect can take up to two times timeout.

  • #1720 dce9fbe - A resource template can parse its variables. With resourceDefinition({ uriTemplate, argsSchema }), argsSchema.parse runs on the template variables before read(uri, variables, ctx) gets them. A read result { text | blob, mimeType } sets the MIME type of that answer.

  • #1720 dce9fbe - New createMCPClient options:

    • toolName: (tool) => string sets the name the model sees for each tool. It wins over prefix. metadata.mcp.serverToolName keeps the server's own name, so callTool() and MCP Apps widget calls still reach the tool. Two tools with the same final name throw DuplicateToolNameError.
    • requestOptions: { timeout, resetTimeoutOnProgress } is sent with tool lists, tool calls, resource requests, and prompt requests. subscriptions/listen and task status polls keep the SDK defaults. A spec 2026 tools/call uses timeout and gets no progress notifications.
    • toolFilter also takes a list of server tool names. The client keeps exactly those tools, in list order. A missing or repeated name throws the new MCPToolFilterError, which names them and the available tools.

    toolName and requestOptions also work per server in createMCPClients and in MCP Apps widget calls.

    Two default changes:

    • A server input schema without properties now gets properties: {}, and a schema without type gets type: 'object'. A full schema does not change.
    • metadata.mcp.annotations is now a frozen copy of the server's annotations, not the server's own object.

Patch Changes