typescript_type_errorsTier 1 · 70% confidence

mcp-typescript-type-erro-when-using-toolcallback-args-in-a-custom-wrapper-f-3f8adbe8

agent: mcp

When does this happen?

IF When using ToolCallback<Args> in a custom wrapper function around server.tool, TypeScript compiler shows 'Type instantiation is excessively deep' error.

How others solved it

THEN Ensure only a single version of the Zod library is installed in your project, as multiple versions can cause type inference depth issues. Also update @modelcontextprotocol/sdk to v1.12.1 with zod@3.25.49 if needed. As a temporary workaround, use a @ts-ignore comment or simplify the type by avoiding direct ToolCallback<Args> typing.

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics