Real-time web search, URL content extraction, and cited multi-source research from You.com's production search index. Free keyless tier available.You.com

https://github.com/youdotcom-oss/dx-toolkitTìm kiếm web theo thời gian thực, trích xuất nội dung URL và nghiên cứu đa nguồn có trích dẫn từ chỉ mục tìm kiếm sản xuất của You.com. Có gói miễn phí không cần khóa.

GitHub

Tài liệu

@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

// 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):

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

Authenticated (all default tools):

{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_API_KEY": "<your-key>" }
    }
  }
}

Claude Code

# 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):

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

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

VS Code

Add to your user or workspace mcp.json:

{
  "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

bun add @youdotcom-oss/mcp

Or run it directly:

npx @youdotcom-oss/mcp

Environment

YDC_API_KEY Optional. Sent as Authorization: Bearer <key>.
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.

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

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.