You.com MCP ServerGive your agent the live web

Web search, page extraction, cited research and finance research in one MCP server. Paste one prompt and your agent installs it for you.

Works in Claude Code, Cursor, Codex and any MCP client. Free to start, no API key.

PROMPT
Example run in Claude Code
No API key
>Read https://you.com/SKILL.md and install this skill.
●Read you.com/SKILL.md
●This host is Claude Code. Install the You.com plugin?
>Yes
$/plugin marketplace add youdotcom-oss/agent-skills
$/plugin install you@you-com
✓Skills added: you-web, you-research, you-finance, you-discover
✓MCP server added: api.you.com/mcp
●Reload the session, then ask me to search.
6 tools
4 skills
OAuth or API key

Works with

Connect You.com where your agents run

Step-by-step setup guides for the coding agents and frameworks you already use.

Coding agents

All agent harnesses ↗

Frameworks and automation

All integrations ↗

How it works

One prompt. Your agent does the setup.

No config files to edit and no key to paste. The prompt points your agent at the You.com onboarding skill, and the skill installs the right MCP setup for the tool you are in.

  1. 01

    Copy the prompt

    One line that tells your agent to read you.com/SKILL.md, the You.com onboarding skill.

  2. 02

    Your agent installs it

    The skill picks the install for your host: the You.com plugin where one exists, or npx skills add everywhere else. It asks before it changes anything.

  3. 03

    Reload and search

    Skills and MCP servers load on the next session. Sign in with your You.com account when your client asks. Keyless search works right away.

Read https://you.com/SKILL.md and install this skill.
Copy onboarding prompt

What your agent gets

Six tools on one server

Your agent calls them like any other tool. Answers come back with the sources it read.

you-search

Live web search

Web and news results with snippets or full page content, plus freshness and domain controls.

Free: 100 queries a day
you-contents

Page extraction

Turn any URL into clean Markdown or HTML your model can read.

Account required
you-research

Cited research

A multi-source answer with citations, at the depth you choose.

Opt in, or use /mcp/research
you-finance

Finance research

Sourced answers about companies, markets and filings.

Opt in, or use /mcp/finance
you-discover

Integration discovery

Finds the right You.com API, SDK or MCP path for what you are building.

Free, no key
you-balance

Account balance

Check your remaining credits without leaving the agent.

Account required

The onboarding prompt also adds four skills that teach your agent when to reach for each tool: you-web, you-research, you-finance and you-discover.

Manual setup

Prefer to add it yourself?

Every client connects to the same hosted server. Find yours and copy the command.

Claude CodePlugin, OAuth
Copy
/plugin marketplace add youdotcom-oss/agent-skills
/plugin install you@you-com
CursorPlugin, OAuth
Copy
/add-plugin you
CodexPlugin
Copy
codex plugin marketplace add youdotcom-oss/agent-skills --sparse .agents/plugins
Any Agent Skills clientSkills and MCP
Copy
npx skills add youdotcom-oss/agent-skills
VS CodeNo key
Copy
code --add-mcp '{"name":"youdotcom","url":"https://api.you.com/mcp?profile=free","type":"http"}'
Any MCP clientNo key
Copy
{
  "mcpServers": {
    "youdotcom": {
      "type": "http",
      "url": "https://api.you.com/mcp?profile=free"
    }
  }
}
See setup for every client in the docs

Access

Start free. Sign in when you need more.

No key

Free search

Add ?profile=free to the server URL for you-search and you-discover with no account. 100 queries a day.

OAuth

Sign in with You.com

Clients that support MCP authorization open a sign-in window the first time they connect. There is no key to paste.

API key

For servers and CI

Send Authorization: Bearer YDC_API_KEY from anything that cannot sign in. Get a key at you.com/platform.

Endpoints

https://api.you.com/mcp
All tools. Search, contents, balance and discover are on by default.
https://api.you.com/mcp?profile=free
Keyless search and discovery.
https://api.you.com/mcp?tools=you-search,you-contents
Limit a connection to the tools you list.
https://api.you.com/mcp/research
Only you-research.
https://api.you.com/mcp/finance
Only you-finance.
https://you.com/docs/_mcp/server
Search the You.com docs. No key.
npx @youdotcom-oss/mcp
The same server run locally over STDIO.

FAQ

Questions about the You.com MCP server

What is the You.com MCP server?+

It is a hosted Model Context Protocol server at api.you.com/mcp that gives AI agents live web search, page extraction, cited research and finance research. Any MCP client can connect to it over HTTP.

What does the onboarding prompt do?+

It tells your agent to read you.com/SKILL.md, the You.com onboarding skill. The skill works out which tool you are in, asks for your approval, then installs the You.com skills and MCP server configs for that host. After you reload the session, your agent can search the web.

Is the You.com MCP server free?+

Web search and integration discovery are free with no account on the keyless profile, up to 100 queries a day. Page extraction, research and finance research use your You.com account, through OAuth sign-in or an API key.

Which clients does it work with?+

Claude Code, Claude Desktop, Cursor, Codex, VS Code, Windsurf, JetBrains IDEs, Zed, Factory Droid, OpenCode, Gemini CLI and any other client that supports remote MCP servers. Several of them also have a You.com plugin that the onboarding prompt installs for you.

Do I need an API key?+

No. Keyless search needs nothing, and clients that support OAuth sign you in with your You.com account. Use an API key for servers, CI and clients without OAuth.

What is the difference between the skills and the MCP server?+

The MCP server provides the tools. The skills are short instructions that teach your agent when to use each tool and how to cite what it finds. The onboarding prompt installs both.

Can I control which tools my agent sees?+

Yes. Add ?tools= to the server URL or send an X-Allowed-Tools header to list the tools for a connection. Research and finance research are off by default, and each also has its own endpoint.

Can I run it locally?+

Yes. Run npx @youdotcom-oss/mcp to use the same server over STDIO. Set YDC_PROFILE=free for keyless search or YDC_API_KEY for the full tool set. OAuth is only available on the hosted server.

Give your agent the live web

Paste the onboarding prompt into your agent, or get an API key and connect any MCP client yourself.