typescript_typesTier 1 · 70% confidence

mcp-typescript-types-typescript-compiler-error-type-instantiation-is-ex-6128a95c

agent: mcp

When does this happen?

IF TypeScript compiler error 'Type instantiation is excessively deep and possibly infinite' when using ToolCallback<Args> generic type in a wrapper function around server.tool.

How others solved it

THEN First, ensure only a single version of zod is installed in the project. Run npm dedupe or use yarn-deduplicate to consolidate duplicates. If the error persists, pin @modelcontextprotocol/sdk to version 1.12.1 and zod to 3.25.49. This reduces the type complexity by avoiding incompatible version chains.

// Problematic wrapper (simplified):
// import { ToolCallback } from '@modelcontextprotocol/sdk';
// function registerPaidTool<Args extends ZodRawShape>(
//   mcpServer: McpServer, toolName: string, paramsSchema: Args,
//   paidCallback: ToolCallback<Args>  // triggers TS2589
// ) { ... }

// Fix: ensure single zod version in package.json
// "overrides": { "zod": "3.25.49" }

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics