OpenCode

View as MarkdownOpen in Claude

Give OpenCode real-time web search, content extraction, and citation-backed research through the You.com MCP Server.

Quick setup

1

Add You.com to your OpenCode config

Edit ~/.config/opencode/opencode.json (or your project-local opencode.json) and add:

1{
2 "mcp": {
3 "you-com": {
4 "type": "remote",
5 "url": "https://api.you.com/mcp?profile=free"
6 }
7 }
8}

This uses the free tier — 100 web searches per day, no signup.

2

Restart OpenCode

$opencode

The server loads on startup. You’ll see you-com listed when you check connected MCP servers.

3

Try it

Search for the latest releases of Bun and summarize the performance improvements.

Higher rate limits + full toolset

For unlimited queries plus you-contents (page extraction) and you-research (citation-backed deep research):

1{
2 "mcp": {
3 "you-com": {
4 "type": "remote",
5 "url": "https://api.you.com/mcp",
6 "headers": {
7 "Authorization": "Bearer YDC-YOUR-API-KEY"
8 }
9 }
10 }
11}

Get a key at you.com/platform.

Local install (stdio)

If you’d prefer to run the MCP server locally:

1{
2 "mcp": {
3 "you-com": {
4 "type": "local",
5 "command": ["npx", "-y", "@youdotcom-oss/mcp"],
6 "environment": {
7 "YDC_API_KEY": "YDC-YOUR-API-KEY"
8 }
9 }
10 }
11}

Omit YDC_API_KEY for free-tier behavior.

Quick demo

Research the OpenCode project: who maintains it, what's the release cadence, and what's on the roadmap.
Extract the README from https://github.com/sst/opencode and summarize the install methods.

Troubleshooting

  • Server doesn’t load — check opencode.json is valid JSON. OpenCode silently skips invalid MCP entries.
  • spawn npx ENOENT (local install only) — install Node.js 18+ and ensure npx is on your PATH.
  • 401 errors — verify the Authorization header is exactly Bearer YDC-... with one space.
  • Tool calls fail with no error — check OpenCode’s logs (opencode --debug) for MCP server errors. Most failures are config-format mismatches.