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.
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.

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. User can authenticate via bearer token or OAuth.

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.

First, identify which client you are running inside: Claude Code, Cursor, Codex, VS Code Copilot, or Windsurf. That host is the one to configure. Add both servers with the mechanism that the host expects. Do not write the config into a different client’s file.

Tell me whether this host needs a restart. Then confirm both servers connect and list the tools they expose.

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.