Getting startedBuild With AgentsAgent Harnesses

OpenCode

View as MarkdownOpen in Claude

The @youdotcom-oss/opencode plugin registers five You.com skills and configures the You.com MCP servers in one install. The MCP servers give OpenCode the tools. The skills tell it when to use each one and how to cite what it finds.

Install our docs MCP server

This documentation ships with a Docs MCP Server that gives any MCP-enabled agent a searchDocs tool to search every page here and get back relevant passages with source URLs—no API key required. Point your client at https://you.com/docs/_mcp/server. See the Docs MCP Server guide for setup and examples.

Install the Plugin

1

Install With OpenCode

opencode plugin @youdotcom-oss/opencode

Or add the plugin to your opencode.json:

{ "plugin": ["@youdotcom-oss/opencode"] }
2

Sign In

The you, you-finance, and you-research servers use OAuth through OpenCode’s remote MCP support. OpenCode prompts you to sign in with your You.com account the first time the agent calls one of their tools. The you-free and you-docs servers need no auth.

3

Try It

Use you-web to find the latest Bun release and summarize the performance improvements.

What the Plugin Configures

MCP serverProvides
youAuthenticated You.com tools
you-freeKeyless web search
you-financeFinance tools
you-researchThe you-research tool
you-docsYou.com docs search

It also registers the you-web, you-research, you-finance, you-discover, and you-free skills.

Use the MCP Server Without the Plugin

To add only the tools, without the skills, configure the MCP server directly.

1

Add You.com to Your OpenCode Config

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

{
  "mcp": {
    "you-com": {
      "type": "remote",
      "url": "https://api.you.com/mcp?profile=free"
    }
  }
}

This uses the free profile: keyless you-search and you-discover, 100 queries 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

For higher limits plus you-contents and you-balance on /mcp. you-research and you-finance need the dedicated paths or an explicit allowlist:

{
  "mcp": {
    "you-com": {
      "type": "remote",
      "url": "https://api.you.com/mcp",
      "headers": {
        "Authorization": "Bearer <YDC_API_KEY>"
      }
    }
  }
}

Get a key at you.com/platform.

Local Install (stdio)

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

{
  "mcp": {
    "you-com": {
      "type": "local",
      "command": ["npx", "-y", "@youdotcom-oss/mcp"],
      "environment": {
        "YDC_API_KEY": "<YDC_API_KEY>"
      }
    }
  }
}

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

Check opencode.json is valid JSON. OpenCode silently skips invalid MCP entries.

For local installs, install Node.js 18+ and ensure npx is on your PATH.

Verify the Authorization header is exactly Bearer YDC-... with one space.

Check OpenCode’s logs (opencode --debug) for MCP server errors. Most failures are config-format mismatches.

Resources

MCP Server Reference

Endpoint, authentication, and full tool reference.

SDKs & Tools Overview

Browse every You.com SDK, agent tool, and integration.