youdotcom-oss/mcp

Local stdio bridge to the hosted You.com MCP server

Before you install: no copy-paste command · no license recorded · link reachable

First step: claude mcp add you -e YDC_PROFILE=free -- npx @youdotcom-oss/mcp

View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site

Install & config

Remote endpoint (mcpServers - Claude Desktop / Cursor / Windsurf)

{
  "mcpServers": {
    "youdotcom-oss-mcp": {
      "url": "https://api.you.com/mcp"
    }
  }
}

Paste this into the mcpServers config of Claude Desktop or Cursor. The endpoint comes from public evidence; we do not install or host it. Official Registry record: this endpoint lists the request header Authorization (Bearer (You.com API key)) but does not mark it required. Whether it works anonymously is for the project docs to say.

VS Code (.vscode/mcp.json - the key is servers, remote needs type: http)

{
  "servers": {
    "youdotcom-oss-mcp": {
      "type": "http",
      "url": "https://api.you.com/mcp"
    }
  }
}

VS Code differs from the other three: the top-level key is <code>servers</code> and a remote endpoint also needs <code>"type": "http"</code>. Paste into .vscode/mcp.json.

Claude Code (command line)

claude mcp add --transport http youdotcom-oss-mcp https://api.you.com/mcp

Claude Code does not read a config file; add the server with this command.

Client config (built from the install command this repo gives)

{
  "mcpServers": {
    "youdotcom-oss-mcp": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"]
    }
  }
}

Parsed from the README we fetched on 2026-11-07; we have not executed it.

command/args come from the install command the repository states. When it is ambiguous, the project README wins.

VS Code (.vscode/mcp.json - the key is servers)

{
  "servers": {
    "youdotcom-oss-mcp": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"]
    }
  }
}

Same server, but VS Code keeps it under <code>servers</code>.

Claude Code (command line)

claude mcp add --transport stdio youdotcom-oss-mcp -- npx @youdotcom-oss/mcp

Claude Code does not read a config file; add the server with this command.

Key names differ by client: Clients & CLI

Source: collected from the abordage/awesome-mcp list · type: MCP server
Harvest history: first seen 2026-11-05 · last seen 2026-11-14 · seen 10× · listed by 10 sources
Score: score 1,003 · 10 sources · mcp
Install: npx @youdotcom-oss/mcp

FAQ (answers come from our records)

How do I install it?

The repository provides this install command: npx @youdotcom-oss/mcp. It comes from the repository itself; we cannot guarantee it runs as-is in your client.

Who is it for?

We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.

Who maintains it?

first catalogued 2026-11-05；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.

# @youdotcom-oss/mcp

以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →

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": " " }
### 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= -- 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
## Install
bash
bun add @youdotcom-oss/mcp
Or run it directly:
bash
npx @youdotcom-oss/mcp
## Environment
YDC_API_KEY
Optional. Sent as Authorization: Bearer .
YDC_PROFILE
Optional. When set to free, routes the bridge to https://api.you.com/mcp?profile=free.
YDC_ALLOWED_TOOLS
Optional. Comma-separated hosted tool ids to expose through https://api.you.com/mcp?tools=....
YDC_PROFILE takes precedence over YDC_ALLOWED_TOOLS.
## Tool exposure
The default hosted MCP URL exposes four tools:
you-search
you-contents
you-balance
you-discover
Two additional tools are available on request:
you-finance
you-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.

Listed badge (optional)

Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.

[![Listed on Anclum](https://anclum.com/badge/listed.svg)](https://anclum.com/en/s/youdotcom-oss-mcp/)

Source: awesome · https://github.com/youdotcom-oss/mcp
Browse by field: MCP servers
Listed by: 10 independent sources
added: today

More like this

nwiizo/tfmcpMCP server microsoft/playwright-mcpMCP server Tiberriver256/mcp-server-azure-devopsMCP server WayStation-ai/mcpMCP server

All 6,229 →

Filed under

MCP servers6,229 entries MCP server6,545 Curated list pick6,618

Every tag opens the full list for that filter. Counts are the live catalogue figures.

Browse all fields →

← Back to index