Claude Code answers from training data by default — which means library APIs, framework syntax, and CLI flags can be months or years out of date. Context7 fixes that by fetching current, version-matched documentation for whatever library you’re actually using, on demand, instead of relying on what the model memorized during training.
Quick Start
Connect the remote server (no local install needed):
claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcpRestart Claude Code, then ask something like “show me a FastAPI example with async endpoints” — if it’s working, the answer will reference current syntax instead of guessing. Total time: about 2 minutes.
⚡ Copy This Prompt: Let Claude Code Install and Verify It For You
Skip Steps 1-3 below and hand the whole thing to the agent instead:
You have access to the `claude mcp` CLI in this project. Do the following and report back — do not tell me it's done unless step 3 actually confirms it:
1. Run `claude mcp list` to see what's already configured.
2. Add Context7: `claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp`
3. Run `claude mcp list` again and confirm context7 shows as Connected.
4. Prove it works: use the context7 tools to look up current documentation for [NAME A LIBRARY YOU ACTUALLY USE, e.g. "Next.js" or "Prisma"] and summarize one recent API detail. If step 3 or 4 fails, tell me the exact error instead of reporting success.This works because Claude Code can run its own CLI commands and then immediately use the newly connected server — so it proves it can actually pull fresh docs instead of just confirming the config exists.
What You’ll Need
| Requirement | Why You Need It | Time |
|---|---|---|
| Claude Code installed | Provides the claude mcp command used to register the server |
0 min |
| Nothing else for basic use | The remote server works unauthenticated at low volume | 0 min |
| A free API key (optional) | Removes rate limits and unlocks private-repo lookups — get one at context7.com/dashboard | ~1 min |
Step-by-Step Setup
Prefer to do it by hand instead of delegating to the agent? Here’s the manual version.
Step 1 — Add the remote server
~1 min
--scope user makes it available in every project on your machine, not just the current one:
claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcpStep 2 — Add an API key to raise the rate limit (optional)
~1 min
Get a free key at context7.com/dashboard, then pass it as a header on the same command:
claude mcp add --scope user --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcpStep 3 — Or run it locally via npx instead
~1 min
If you’d rather not send lookups to the hosted endpoint, run the same server as a local stdio process:
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEYStep 4 — Restart and use it
~1 min
Run claude to start a fresh session, then just ask a normal question about a library — Context7 kicks in automatically when it’s relevant, no special syntax required.
What Each Piece Does
| Piece | What It Does |
|---|---|
Remote HTTP endpoint (mcp.context7.com/mcp) |
Hosted server, no local process to keep running |
CONTEXT7_API_KEY header |
Raises your rate limit and enables private-repo documentation lookups |
| Local npx alternative | Same tools, self-hosted — useful if you can’t send traffic to the hosted endpoint |
--scope user |
Makes the server available in every project on your machine, not just one repo |
Verify It’s Actually Pulling Fresh Docs
claude mcp list✘ context7 Failed to connect
“Connected” only confirms the handshake. The real test is asking about a library you know has changed recently and checking the answer reflects that:
What's the current recommended way to set up middleware in [a framework you use]? Use Context7 to check current docs before answering, and tell me which version the docs you pulled are for.If the answer cites a specific version and matches what’s actually in that library’s current docs (not what an older training cutoff would guess), it’s working end to end.
Common Mistakes to Avoid
- Assuming it’s used automatically every time. Claude decides when a query needs current docs versus when its own knowledge is sufficient — if you want to force it, say “use Context7” explicitly in the prompt.
- Hitting rate limits on the free unauthenticated tier. Add an API key (Step 2) if you’re using it heavily — it’s free and takes about a minute.
- Confusing this with a general web search tool. It’s scoped to library/framework/API documentation, not general current events or arbitrary web content.
- Not restarting after adding the server. Claude Code needs a fresh session or an
/mcppanel refresh to pick up a newly added server.
Q&A
Do I need an API key to use it at all?
No — it works unauthenticated at low volume. A free key from context7.com/dashboard just raises the rate limit and adds private-repo access.
How is this different from just asking Claude directly?
Claude’s own knowledge has a training cutoff and can be wrong about recent API changes. Context7 fetches the library’s actual current documentation at query time, so the answer reflects what’s true right now, not what was true when the model was trained.
Does it work for any library?
It covers a large and growing index of popular libraries and frameworks. For very obscure or brand-new packages, coverage may be incomplete — in that case Claude falls back to its own knowledge.
Can I remove it later?
Yes — claude mcp remove context7 deletes it from the config.
Official Resources
- Context7 Documentation — setup guides for every MCP client
- Context7 Dashboard — create a free API key
- Claude Code MCP Documentation — the
claude mcpcommand reference
If this guide got Claude Code pulling current docs instead of guessing, follow us on X for more setup guides and prompt tips.
