The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the You.com Web Access & AI listing page.
Add real-time web search, research, and content extraction to any agent. Hosted MCP server, free tier with no API key, plus first-party plugins for the Vercel AI SDK and LangChain.
If your client supports remote MCP, point it at https://api.you.com/mcp?profile=free directly — no local process needed.
?profile=free exposes you-search to any MCP client with zero auth.io.github.youdotcom-oss/mcp.https://api.you.com/mcp.Every snippet below works against the free tier. To unlock you-research and you-contents, drop the YDC_PROFILE line and set YDC_API_KEY to a key from you.com/platform/api-keys. you-finance is opt-in — pass ?tools=you-finance on the URL or set YDC_ALLOWED_TOOLS=you-finance.
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Authenticated (all default tools):
Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
Add to ~/.codeium/windsurf/mcp_config.json:
Add to your user or workspace mcp.json:
If your client speaks streamable HTTP, skip the local bridge:
Authenticated:
| Package | What it does |
|---|---|
@youdotcom-oss/mcp | STDIO bridge to the hosted MCP server. Use this when your client needs a local command. |
@youdotcom-oss/ai-sdk-plugin | Vercel AI SDK tools backed by the hosted MCP server. |
@youdotcom-oss/langchain | LangChain.js tools backed by the hosted MCP server. |
@youdotcom-oss/cli | ydc CLI for listing tools, fetching schemas, and invoking remote tools from a shell. |
The free profile (?profile=free) exposes you-search only. The authenticated default exposes you-search, you-research, and you-contents. you-finance is available on request via ?tools=you-finance.
Once @youdotcom-oss/mcp is wired into Claude Desktop (see above), ask Claude:
Search the web for the latest releases of Bun and summarize the changes since 1.2.
Claude calls you-search directly. No code required.
io.github.youdotcom-oss/mcpThis is a Bun workspace monorepo. Development setup, workspace commands, and code conventions live in AGENTS.md; contribution flow and PR conventions live in CONTRIBUTING.md. Issues and PRs welcome.
MIT — see LICENSE.