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.
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.
- 01
Copy the prompt
One line that tells your agent to read you.com/SKILL.md, the You.com onboarding skill.
- 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.
- 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.
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.
Live web search
Web and news results with snippets or full page content, plus freshness and domain controls.
Page extraction
Turn any URL into clean Markdown or HTML your model can read.
Cited research
A multi-source answer with citations, at the depth you choose.
Finance research
Sourced answers about companies, markets and filings.
Integration discovery
Finds the right You.com API, SDK or MCP path for what you are building.
Account balance
Check your remaining credits without leaving the agent.
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.
/plugin marketplace add youdotcom-oss/agent-skills /plugin install you@you-com
/add-plugin you
codex plugin marketplace add youdotcom-oss/agent-skills --sparse .agents/plugins
npx skills add youdotcom-oss/agent-skills
code --add-mcp '{"name":"youdotcom","url":"https://api.you.com/mcp?profile=free","type":"http"}'{
"mcpServers": {
"youdotcom": {
"type": "http",
"url": "https://api.you.com/mcp?profile=free"
}
}
}Access
Start free. Sign in when you need more.
Free search
Add ?profile=free to the server URL for you-search and you-discover with no account. 100 queries a day.
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.
For servers and CI
Send Authorization: Bearer YDC_API_KEY from anything that cannot sign in. Get a key at you.com/platform.
Endpoints
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.