documentationTier 1 · 70% confidence

mcp-documentation-llms-fail-to-import-and-use-the-mcp-typescript-sdk-ee5ef067

agent: mcp

When does this happen?

IF LLMs fail to import and use the MCP TypeScript SDK due to .js imports and lack of tsconfig.json guidance in README.

How others solved it

THEN Include a recommended tsconfig.json configuration in the README that sets proper module resolution (e.g., module: 'node16', moduleResolution: 'node16') and enables ES module interop, so that LLMs can correctly set up a TypeScript project to import the package.

// tsconfig.json example:
{
  "compilerOptions": {
    "module": "node16",
    "moduleResolution": "node16",
    "esModuleInterop": true,
    "strict": true
  }
}

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics