- Bump every version pin, pricing table, and model ID to the verified 2026-07-05 state (v1.17.13): Claude Fable 5 / Sonnet 5 on Zen, new free tier, deprecation sunset table, v1.17.x changelog section - Cover gaps: OpenCode Go vs Zen billing, Anthropic subscription-login removal (PR #18186), MCP resources, --mini mode, --auto flag, yolo mode - Fix correctness bugs: command-template !`cmd` syntax in docs and .opencode/commands, protect-secrets regex missing 'cat .env', dual plugin exports, quickstart PATH fix, Playwright MCP flags, ctrl+d keybind conflict, agent/command required-field claims - Fix links: cursor.com, windsurf.com, platform.claude.com, code.claude.com, opencode.ai/discord, Vercel Grep announcement - Rebrand: banner (Images/banner.svg), 1280x640 social preview asset, hero redesign with star CTA, ecosystem stats, private vulnerability reporting channel, CI-matching local checks, MD060 lint opt-out
MCP Server Walkthroughs
Practical setup guides for MCP servers that pair well with OpenCode. New to MCP itself? Read
docs/mcp.mdfirst.
Featured servers
| Server | Adds | Type | Walkthrough |
|---|---|---|---|
| Playwright | Browser automation — DOM, network, screenshots, accessibility | local | playwright.md |
| Context7 | Live, version-pinned library docs piped into the prompt | remote | context7.md |
| Sentry | Errors, traces, releases | remote (OAuth) | sentry.md |
| Grep by Vercel | Code search across public GitHub | remote | grep.md |
When to add an MCP server
- Your AI needs external state (browser, DB, ticketing, error tracker)
- You repeatedly run the same external CLI/API from within OpenCode prompts
- You want OpenCode to act on a system, not just describe it
If everything you need is already in local files, you probably don't need MCP yet.
💡 Each walkthrough below shows the
opencode.jsonentry to hand-edit. To register a server interactively instead, runopencode mcp addand answer the prompts.
Cost of adding a server
Every server's tool descriptions land in the model's context on every turn — a heavy server can cost thousands of tokens before you call anything. See the token budget warning in docs/mcp.md for the details and the tools-map pattern for disabling tools you don't need.
Discovery
The official MCP Registry lists vetted servers. Search the registry or check the docs for each individual server.
For new servers, also worth checking:
- github.com/modelcontextprotocol/servers — reference implementations
- The provider's own docs (Sentry, Atlassian, etc. publish their own MCP guides)
General troubleshooting
| Problem | Try |
|---|---|
| Server won't connect | opencode mcp debug <name> |
| OAuth flow stuck | opencode mcp logout <name> then opencode mcp auth <name> |
| Tools missing in the model surface | Check the tools map and the agent's tools override |
| Local server fails on Windows | Make sure the command array uses npx with -y, and that Node 20+ (current LTS) is on PATH |
| Timeouts | Bump timeout (default 5000ms) under the server's config |
📚 Full MCP guide in OpenCode: opencode.ai/docs/mcp-servers.