Context7 MCP: "Documentation not found or not finalized" error in Claude Code — fix?

Question

Context7 MCP in Claude Code (version 1.0.11) returns "Documentation not found or not finalized for this library" on every docs call, even when resolve-library-id returns a library ID like /jetbrains/lets-plot. The server is started with npx -y @upstash/context7-mcp from a local .mcp.json with DEFAULT_MINIMUM_TOKENS set. The error suggests using resolve-library-id, but that tool already works. What fixes the docs retrieval failure?

Originally asked on GitHub: https://github.com/upstash/context7/issues/246

AgentArmorHQ team · Accepted Answer

Status: the issue was closed as completed; maintainers could not reproduce it, but one commenter reported a working fix: launch the Context7 MCP server with `@latest` plus `--node-options=--experimental-fetch`. The thread does not specify exactly where the flag belongs; placing it in the `args` array of your MCP server config (as in the example below) is the usual npx pattern, but that placement is general advice.

Example based on the Claude Code 1.0.11 config that failed:

```json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest",
        "--node-options=--experimental-fetch"
      ],
      "env": {
        "DEFAULT_MINIMUM_TOKENS": "6000"
      }
    }
  }
}
```

The same "Documentation not found or not finalized" error appeared with several different library IDs (`/starrocks/starrocks`, `/openai/openai-python`, and `/jetbrains/lets-plot` after `resolve-library-id` returned it) and when connecting through `https://mcp.context7.com/sse` in Anthropic Claude. So the error message's hint to resolve the library ID again was not the fix for these users. A maintainer also suggested checking the troubleshooting section of the README if the problem persists.

AgentArmorHQ team · Answer

**What @combiz tried on GitHub** (Worked)

A commenter reported that combining `--node-options=--experimental-fetch` with the `@latest` version tag in the npx command fixed the error.

Source: https://github.com/upstash/context7/issues/246#issuecomment-2944231517

AgentArmorHQ team · Answer

**What a GitHub user tried on GitHub** (Didn't work)

The reporter passed `context7CompatibleLibraryID: "/starrocks/starrocks"` and got the "Documentation not found or not finalized" error, and noted that the suggested `resolve-library-id` tool appeared unavailable.

Source: https://github.com/upstash/context7/issues/246

AgentArmorHQ team · Answer

**What @ALegenda tried on GitHub** (Didn't work)

A user tried `/openai/openai-python` with topic "responses API structured output function calling" and tokens 8000; the same error was returned.

Source: https://github.com/upstash/context7/issues/246#issuecomment-2933680002

AgentArmorHQ team · Answer

**What @AlphonseP tried on GitHub** (Didn't work)

Connecting via `https://mcp.context7.com/sse` in Anthropic Claude: `resolve-library-id` worked, but the docs call returned the same "Documentation not found" message.

Source: https://github.com/upstash/context7/issues/246#issuecomment-2936714951

AgentArmorHQ team · Answer

**What @combiz tried on GitHub** (Didn't work)

Claude Code 1.0.11 with a local `.mcp.json` using `npx -y @upstash/context7-mcp` and `DEFAULT_MINIMUM_TOKENS: 6000`: `resolve-library-id` returned `/jetbrains/lets-plot`, but `get-library-docs` still failed.

Source: https://github.com/upstash/context7/issues/246#issuecomment-2943378748

Context7 MCP: "Documentation not found or not finalized" error in Claude Code — fix?

6 answers

Add your answer or comment

Context7 MCP: "Documentation not found or not finalized" error in Claude Code — fix?

6 answers

Add your answer or comment

Related questions