Files
Wesam Abousaid a3f328c043 docs: refresh for OpenCode v1.17.13, add Go coverage, and rebrand
- 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
2026-07-05 14:11:51 +02:00
..

MCP Server Walkthroughs

Practical setup guides for MCP servers that pair well with OpenCode. New to MCP itself? Read docs/mcp.md first.

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.json entry to hand-edit. To register a server interactively instead, run opencode mcp add and 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:

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.