@youdotcom-oss/mcp
Bin-only STDIO bridge for the hosted You.com MCP server at https://api.you.com/mcp.
This package does not register tools locally and does not contain REST tool logic. Its only job is to proxy STDIO MCP traffic to the hosted remote server.
Quick start```jsonc
// Add this to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.)
// Free tier — no API key, no signup.
{
"mcpServers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
If your client supports remote MCP, point it at `https://api.you.com/mcp?profile=free` directly — no local process needed.
### Claude Desktop
Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):```jsonc
{
"mcpServers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
Authenticated (all default tools):```jsonc
{
"mcpServers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_API_KEY": "<your-key>" }
}
}
}
### Claude Code```bash
# Free tier
claude mcp add you -e YDC_PROFILE=free -- npx @youdotcom-oss/mcp
# Authenticated
claude mcp add you -e YDC_API_KEY=<your-key> -- npx @youdotcom-oss/mcp
Cursor
Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):```jsonc
{
"mcpServers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
### Windsurf
Add to `~/.codeium/windsurf/mcp_config.json`:```jsonc
{
"mcpServers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
VS Code
Add to your user or workspace mcp.json:```jsonc
{
"servers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
### Any MCP client (remote)
If your client speaks streamable HTTP, skip the local bridge:```
https://api.you.com/mcp?profile=free
Authenticated:```
https://api.you.com/mcp
Authorization: Bearer <your-key>
## Install```bash
bun add @youdotcom-oss/mcp
Or run it directly:bash
npx @youdotcom-oss/mcp
Environment
YDC_API_KEY
Optional. Sent asAuthorization: Bearer.YDC_PROFILE
Optional. When set tofree, routes the bridge tohttps://api.you.com/mcp?profile=free.YDC_ALLOWED_TOOLS
Optional. Comma-separated hosted tool ids to expose throughhttps://api.you.com/mcp?tools=....
YDC_PROFILE takes precedence over YDC_ALLOWED_TOOLS.
Tool exposure
The default hosted MCP URL exposes four tools:
you-searchyou-contentsyou-balanceyou-discover
Two additional tools are available on request:
you-financeyou-research
Request additional tools explicitly with tools. tools scopes the visible tool set.
Today, profile=free is a keyless mode. It overrides tools and exposes you-search and you-discover.
Examples:
- Default tool set:
https://api.you.com/mcp - Finance only:
https://api.you.com/mcp?tools=you-finance - Search plus finance:
https://api.you.com/mcp?tools=you-search,you-finance - Research only:
https://api.you.com/mcp?tools=you-research - Free profile (keyless):
https://api.you.com/mcp?profile=free
Links
- API keys: you.com/platform/api-keys
- Platform docs: documentation.you.com
- MCP registry listing:
io.github.youdotcom-oss/mcp - Issues: github.com/youdotcom-oss/mcp/issues
- Support: support@you.com
Contributing
Development setup and code conventions live in AGENTS.md; contribution flow and PR conventions live in CONTRIBUTING.md. Issues and PRs welcome.
License
MIT — see LICENSE.