English Français العربية

You.com Web Access & AI

Official registry Search and web

Web search, AI agent, and content extraction via You.com APIs

Source code Documentation

What can you do with You.com Web Access & AI?

  • you-search
  • you-contents
  • you-balance
  • you-discover
  • you-finance
  • you-research
  • Default tool set: https://api.you.com/mcp
  • Finance only: https://api.you.com/mcp?tools=you-finance

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http you-com-web-access-ai 'https://api.you.com/mcp' --header 'Authorization: <Bearer (You.com API key)>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "you-com-web-access-ai": {
            "type": "http",
            "url": "https://api.you.com/mcp",
            "headers": {
                "Authorization": "<Bearer (You.com API key)>"
            }
        }
    }
}
NPM package @youdotcom-oss/mcp
Claude Code 
claude mcp add you-com-web-access-ai -e 'YDC_API_KEY=<your ydc_api_key>' -e 'YDC_PROFILE=<YDC_PROFILE>' -e 'YDC_ALLOWED_TOOLS=<YDC_ALLOWED_TOOLS>' -- npx -y @youdotcom-oss/mcp@4.0.6
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "you-com-web-access-ai": {
            "command": "npx",
            "args": [
                "-y",
                "@youdotcom-oss/mcp@4.0.6"
            ],
            "env": {
                "YDC_API_KEY": "<your ydc_api_key>",
                "YDC_PROFILE": "<YDC_PROFILE>",
                "YDC_ALLOWED_TOOLS": "<YDC_ALLOWED_TOOLS>"
            }
        }
    }
}

Environment variables

  • YDC_API_KEY secret You.com API key (optional — omit for free tier)
  • YDC_PROFILE Hosted MCP profile to expose through the STDIO bridge (currently supports free)
  • YDC_ALLOWED_TOOLS Comma-separated hosted tool ids to expose through the STDIO bridge

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @youdotcom-oss/mcp
  2. Quick start
  3. Install
  4. Environment
  5. Tool exposure
  6. Links
  7. Contributing
  8. License

@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.

Frequently asked questions

What is You.com Web Access & AI?

Web search, AI agent, and content extraction via You.com APIs

How do I install You.com Web Access & AI?

It runs as a remote server. In Claude Code: claude mcp add --transport http you-com-web-access-ai 'https://api.you.com/mcp' --header 'Authorization: <Bearer (You.com API key)>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does You.com Web Access & AI need an API key?

Yes. It expects YDC_API_KEY, Authorization, which you set in its configuration.

Is You.com Web Access & AI open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains You.com Web Access & AI?

It is published by youdotcom-oss. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.