Add You.com to Claude Code

The You.com plugin for Claude Code installs four skills and the You.com MCP servers in one step. The MCP servers give Claude tools such as you-search, you-contents, you-research, and you-finance. The skills tell Claude when to use each tool, how to cite what it finds, and which endpoint fits the task.

Install the Docs MCP server

The Docs MCP server lets your agent search over the entirety of these docs. Free to use.

Install https://you.com/docs/_mcp/server. See the Docs MCP Server guide to learn more.

Install the Plugin

Add the You.com Marketplace

Inside a Claude Code session:

/plugin marketplace add youdotcom-oss/agent-skills

This registers the you-com marketplace from the agent-skills repo.

Install From the Marketplace

/plugin install you@you-com

Pick an install scope when prompted. User makes the plugin available in every project. Project writes it to .claude/settings.json so everyone who clones the repo gets it. If the install summary asks you to, run /reload-plugins.

Try It

Use you-web to find what's new in the latest TypeScript release, with sources.

To install from your terminal instead, for example in a setup script, use the claude plugin CLI:

claude plugin marketplace add youdotcom-oss/agent-skills
claude plugin install you@you-com --scope user

What the Plugin Installs

MCP servers. Run /mcp to see them:

Server	Endpoint	Tools
`you`	`https://api.you.com/mcp`	Default four: `you-search`, `you-contents`, `you-balance`, and `you-discover`
`you-research`	`https://api.you.com/mcp/research`	`you-research`
`you-finance`	`https://api.you.com/mcp/finance`	`you-finance`
`you-discover`	`https://api.you.com/mcp?profile=discover`	`you-discover`, with no sign-in

The you entry is bare /mcp, so research and finance run on their own servers. To keep them on one connection instead, allow them on https://api.you.com/mcp?tools=.

Skills. Plugin skills are namespaced under the plugin name, so you can call one directly, such as /you:you-web. Claude also loads them on its own when a task matches:

Skill	Use it for
`you-web`	Current web search and URL reading, with sources cited. Switches to keyless `you-search` when no credentials are set.
`you-research`	Choosing between agent-led searching and a single cited `you-research` call
`you-finance`	Finance questions through the `you-finance` tool
`you-discover`	Finding the right You.com API, MCP server, or SDK for a project you’re building

Example Prompts

Use you-research to compare WebAssembly and JavaScript for performance-critical browser apps. Cite sources.

Extract the content from https://modelcontextprotocol.io/specification and summarize the authentication section.

Use you-finance to summarize NVIDIA's most recent quarterly results.

Use you-discover to find the best way to add You.com search to a TypeScript agent built on the Vercel AI SDK.

Keep the Plugin Updated

Refresh the marketplace to pick up new skill versions, then reinstall:

/plugin marketplace update you-com
/plugin install you@you-com

Use the MCP Server Without the Plugin

If you only want the tools, add the You.com MCP server directly. You get the same tools without the skills.

OAuth (recommended):

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

API key (useful for CI, scripts, and shared dev containers). Get a key at you.com/platform:

claude mcp add --transport http you-com https://api.you.com/mcp \
  --header "Authorization: Bearer <YDC_API_KEY>"

Free profile (you-search and you-discover, 100 queries per day, no account):

claude mcp add --transport http you-com "https://api.you.com/mcp?profile=free"

Troubleshooting

Plugin not found in marketplace

Refresh the marketplace with /plugin marketplace update you-com and retry /plugin install you@you-com. If /plugin isn’t recognized, update Claude Code with claude update.

Skills don't appear after install

Run /reload-plugins, or restart Claude Code. Plugin skills show up under the you: namespace.

OAuth window doesn't open

Run /mcp, select the You.com server, and choose to authenticate. Confirm Claude Code is up to date with claude --version.

401 with an API key

Check for extra spaces or smart quotes in the --header value.

Duplicate You.com tools

If you added the MCP server by hand before installing the plugin, remove the manual entry with claude mcp remove you-com.

Resources

Agent Skills

What each You.com skill does and how to install skills in other agents.

MCP Server Reference

Endpoints, authentication, and the full tool reference.

Star