Files
opencode-primer/mcp-servers/context7.md
Wesam Abousaid d75be39290 feat(mcp-servers): walkthroughs for Playwright, Context7, Sentry, Grep
Each walkthrough follows the same template: when to reach for it, setup
(verbatim opencode.json snippet), example prompts, capabilities and
limitations, gotchas, resources.

- playwright.md: browser automation — visual iteration loop, e2e
  scaffolding, bug repro from a URL
- context7.md: live, version-pinned library docs piped into the prompt,
  with the "resolve first, query second" pattern
- sentry.md: errors / traces / releases via OAuth (DCR), with the
  error-to-root-cause pattern
- grep.md: code search across public GitHub via the Vercel-hosted MCP

README.md ranks "when to add a server" against the cost of the extra
tokens it puts in the model's context every turn, with a tools-map
example for disabling chatty MCP tools per agent.

All endpoint URLs and package names link-checked at commit time.
2026-05-18 20:00:21 +02:00

3.0 KiB

Context7 MCP

Live, version-pinned library documentation piped into the prompt. Grounds OpenCode's answers in current API surfaces — not training-data approximations.

Why this matters

LLMs hallucinate APIs that don't exist or use APIs that were deprecated three versions ago. Context7 fetches real documentation for the libraries you're using at the version you're using, and surfaces it to the model.

When to reach for it

  • Working with a library you don't know well
  • Working with a library that's recently changed (new React versions, framework migrations)
  • Debugging "this function should exist but it doesn't" confusion
  • Writing code for SDKs/APIs the model's training data doesn't cover well

Setup

Get an API key at context7.com.

Add to opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}"
      }
    }
  }
}

Set the env var in your shell:

export CONTEXT7_API_KEY=ctx7_...

Restart OpenCode. Verify:

opencode mcp list

Example prompts

use context7 to look up the React Router v7 docs for `loader` functions —
specifically how to handle redirects from a loader
I'm migrating from Next.js 14 to 15. Use context7 to find the breaking
changes in the App Router and surface the ones that affect our project.
use context7 to check the latest Stripe API for the recommended way to
handle webhook signature verification with raw bodies

Resolve before you query

Context7 resolves a library name + version before fetching docs. Patterns that work:

context7: resolve "next.js" v15 — then look up streaming rendering
context7: resolve "tailwindcss" v4 — show me the breaking changes from v3

You can also just name the library; Context7 will resolve to the latest version it knows.

What it covers

Thousands of libraries — React, Next.js, Vue, Angular, Svelte, Tailwind, TanStack, Prisma, Drizzle, Hono, Fastify, Express, Django, FastAPI, Spring, Rails, etc. — plus most major SaaS SDKs (Stripe, Twilio, Sentry, etc.).

What it won't do

  • Cover your private code or internal docs (use Memory MCP or a custom internal MCP for that)
  • Replace reading the actual codebase (it grounds in docs, not your usage)
  • Cover obscure libraries with no real documentation

Gotchas

  • API key required — there's a free tier, but you need to sign up.
  • Token budget — Context7 returns chunks of docs; very chatty queries can push past your context window. Be specific in what you ask for.
  • Version drift — pin the version explicitly when your repo's package.json is behind latest.

Resources