Build With Agents | You.com

Agents can use our APIs via the You.com MCP server, read these docs via the Docs MCP server, and execute Skills to steer their behavior. You can set this up in a single prompt.

Onboard your agent

Which Docs to Fetch

Resource	What it returns	Fetch it when
`llms.txt`	An index of every page	You need the site structure
Page `.md`	One page as Markdown	You know the page. Append `.md` to its URL.
Docs MCP	Passages that match a `searchDocs` query	Your agent should search the docs

How to Connect

If you are	Use	Start
Building a production app	Python SDK or REST	Quickstart. Framework setups are on Integrations.
Setting up a team IDE	Product MCP	Cursor and Claude Code install the plugin. Other clients use the server URL.
Working in your own local session	Skills and Agent Harnesses	`npx skills add youdotcom-oss/agent-skills` installs the skills. Each harness page connects the server.
Connecting with no credentials	`?profile=free`, Docs MCP, or x402	Add `https://api.you.com/mcp?profile=free` to your client. x402 pays per request for the Web Search API and the Finance Research API.

Which Capability

Each API fits a different job. Choose the Right API compares latency and price.

Capability	Use it when
Web Search API	Sources are unknown and you need ranked web or news results.
Inference Router API	You want leading open-weight models grounded in real-time web search, through an OpenAI or Anthropic SDK.
Contents API	You already have the URL and need the page as Markdown or HTML.
Answer API	You want one cited answer from a single search pass, called over REST.
Research API	The question needs several searches and a cited write-up.
Finance Research API	The question is about filings, prices, fundamentals, or financial news.

Install From This Host

To install both MCP servers without the onboarding skill, run this prompt in your agent.

Install the You.com MCP servers

Install the You.com MCP servers so that you, the coding agent I’m currently talking to, can call them.

Before you write any MCP config, check whether this host already offers the You.com plugin (for example Claude Code, Cursor, Codex, GitHub Copilot CLI, OpenCode, Grok Build, Kimi Code, Hermes, Pi, OpenClaw, or DeepSeek Harness). If it does, tell me and ask whether I want it. The plugin adds the You.com skills and signs in with OAuth. Install it only after I say yes. If I say yes, skip the keyless Product MCP server, and add Docs MCP when the plugin did not include it. If I decline, or this host has no plugin, add the keyless servers below.

Product MCP, live APIs, no API key:

* Server URL: `https://api.you.com/mcp?profile=free`
* Transport: streamable HTTP
* Auth: none. This profile exposes you-search (100 queries per day) and you-discover. Do not add an API key unless I ask.

Docs MCP. Search these docs. Fully free to use:

* Server URL: `https://you.com/docs/_mcp/server`
* Transport: streamable HTTP
* Auth: none. The tool is searchDocs.

Configure the host you are running in with the mechanism that host expects. Do not write the config into a different client’s file.

Tell me whether a restart is needed. Then confirm the servers connect. Run one you-search query and return one source link from the results. On Docs MCP, run one searchDocs call.

Docs MCP vs Product MCP

Use Docs MCP to read and search this documentation site. Use Product MCP to call the APIs.

Server	URL	Auth	Tools
Docs MCP	`https://you.com/docs/_mcp/server`	None	`searchDocs` over these developer docs
Product MCP	`https://api.you.com/mcp`	API key or OAuth. `?profile=free` is keyless.	Live API tools. `?profile=free` allows `you-search` and `you-discover`, 100 queries per day. Research and finance use `/mcp/research` and `/mcp/finance`, or `?tools=` on `/mcp`.

Answer API is not available via MCP.

TypeScript, MCP, or the Python SDK

TypeScript and JavaScript have three paths. Use fetch against the REST APIs when the application needs the JSON. Use @youdotcom-oss/mcp, or the hosted server at https://api.you.com/mcp, when an agent should call the tools. Use the Python SDK when you want a typed client that tracks new API fields. The @youdotcom-oss/sdk package is deprecated.