> For clean Markdown of any page, append `.md` to the page URL.
> Documentation index: https://you.com/docs/llms.txt (section indexes: append `/llms.txt` to any section URL).
> Search these docs: Docs MCP at https://you.com/docs/_mcp/server (`searchDocs`, no API key).
> Call live You.com APIs: Product MCP at https://api.you.com/mcp (free Search only: `?profile=free`). To pick an API or integration path, call `you-discover` on that server instead of guessing.
> OpenAPI: https://you.com/docs/openapi.json—auth header `X-API-Key`, env `YDC_API_KEY`.

# Agents

> Two MCP servers: Docs MCP (searchDocs, no key, https://you.com/docs/_mcp/server) vs Product MCP (live APIs, https://api.you.com/mcp).

You.com runs two MCP servers with different URLs and different jobs.

## Docs MCP vs Product MCP

| 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 | Live APIs: `you-search`, `you-contents`, `you-answer`, `you-research`, `you-finance`, `you-discover` |
| Product MCP (free) | `https://api.you.com/mcp?profile=free` | None             | `you-search` only, 100 queries per day                                                               |

Use Docs MCP to read these pages. Use Product MCP to call the live APIs. `https://you.com/_mcp/server` is not Docs MCP—it redirects to sign-in.

Setup is in the [Docs MCP Server](/docs/build-with-agents/docs-mcp-server) guide and the [MCP Server](/docs/build-with-agents/mcp-server) guide.

## Pick an API

The five REST APIs are listed in the [Quickstart](/docs/quickstart). Open the overview that matches the job:

* [Web Search API](/docs/guides/search)—ranked web and news JSON for your own pipeline
* [Answer API](/docs/guides/answer)—one-call cited Markdown from a single search
* [Contents API](/docs/guides/contents)—Markdown or HTML from URLs you already have
* [Research API](/docs/guides/research)—multi-step cited answers with depth control
* [Finance Research API](/docs/guides/finance-research)—cited answers from a finance-optimized index

Web Search and Contents use `ydc-index.io`. Answer, Research, and Finance Research use `api.you.com`. Auth header: `X-API-Key`. Environment variable: `YDC_API_KEY`.

## Agent Skills

Installable instruction packs live on [Agent Skills](/docs/build-with-agents/skills) (`npx skills add youdotcom-oss/agent-skills`). They route to Product MCP tools, Docs MCP `searchDocs`, or direct REST. A skill does not replace connecting an MCP server.

Documentation index: `https://you.com/docs/llms.txt`. Append `.md` to any docs URL for the Markdown export of that page.