# You.com MCP Server

> Give your agent live web search, full page content, cited research and finance research from You.com.

You.com's own MCP server. It gives your agent live web search, page content extraction, citation-backed research and finance research through You.com's APIs. It's hosted at https://api.you.com/mcp, and the @youdotcom-oss/mcp package runs it locally over STDIO.

What you can do with it
- Search the web and news for current information, facts and primary sources (you-search)
- Extract the full content of web pages as Markdown or HTML (you-contents)
- Run citation-backed research on a question (you-research)
- Run finance research (you-finance)
- Check your You.com account balance (you-balance)
- Discover AI agents, MCP servers and skills (you-discover)

How it connects
The hosted server at https://api.you.com/mcp offers you-search, you-contents, you-balance and you-discover by default. Agents that support MCP sign-in (OAuth 2.1) connect without a key and sign you in to You.com; for the others, send a You.com API key as an Authorization: Bearer header. Add you-research or you-finance with ?tools= (for example ?tools=you-search,you-finance), or connect to https://api.you.com/mcp/research or https://api.you.com/mcp/finance.
To try it without an account, https://api.you.com/mcp?profile=free offers you-search and you-discover with no key, up to 100 queries a day.
The local package (npx @youdotcom-oss/mcp) needs either YDC_PROFILE=free or a YDC_API_KEY, and it doesn't support OAuth.
You.com documents setup for Claude Code, Claude Desktop, Cursor, VS Code, Codex, Gemini CLI, Windsurf, Zed, JetBrains IDEs, OpenCode and more.

Good to know
- you-research and you-finance have no free usage.
- API keys come from you.com/platform.
- You.com also offers a plugin for Claude Code, Cursor and other coding agents that adds its agent skills alongside these servers.

- Type: Plugin
- Made by: You.com
- Category: Web & browser
- Formats: Remote MCP, Local MCP
- Version: 4.0.6
- Website: https://you.com/docs/agents/mcp-server
- Source: https://github.com/youdotcom-oss/mcp
- Page: https://pluginboard.ai/plugins/you-com-mcp

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

You'll need:

- `Authorization` (optional): Bearer (You.com API key)

Replace each `<NAME>` placeholder with your own value.

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://api.you.com/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://api.you.com/mcp

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://api.you.com/mcp. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://api.you.com/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Gemini

In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://api.you.com/mcp

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://api.you.com/mcp and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22you-com-mcp-server%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.you.com%2Fmcp%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http you-com-mcp-server https://api.you.com/mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=you-com-mcp-server&config=eyJ1cmwiOiJodHRwczovL2FwaS55b3UuY29tL21jcCJ9

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "you-com-mcp-server": {
      "url": "https://api.you.com/mcp"
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http you-com-mcp-server https://api.you.com/mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add you-com-mcp-server --url https://api.you.com/mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "you-com-mcp-server": {
      "url": "https://api.you.com/mcp"
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http you-com-mcp-server https://api.you.com/mcp
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://api.you.com/mcp (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add you-com-mcp-server --url https://api.you.com/mcp --transport streamable-http
```

If it needs a key or sign-in: For https://api.you.com/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login you-com-mcp-server.

### OpenCode

Run in your terminal:

```shell
opencode mcp add you-com-mcp-server --url https://api.you.com/mcp
```

If it needs a key: For https://api.you.com/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add you-com-mcp-server --url https://api.you.com/mcp
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "you-com-mcp-server": {
      "url": "https://api.you.com/mcp"
    }
  }
}
```

If it signs in with OAuth: If https://api.you.com/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).