> 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 (keyless `?profile=free` exposes `you-search` and `you-discover`. Research and finance use `/mcp/research`, `/mcp/finance`, or `?tools=` on `/mcp`). 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`. # Build With Agents > Give any agent real-time web access: install a You.com MCP server, add the Agent Skills, or call the REST APIs directly. Agents can use our APIs via the [You.com MCP server](/docs/agents/mcp-server), read these docs via the [Docs MCP server](/docs/agents/docs-mcp-server), and execute [Skills](/docs/agents/skills) to steer their behavior. You can set this up in a single prompt. #### Onboard your agent Read you.com/SKILL.md, install the skill present there, and execute the steps. ## Which Docs to Fetch | Resource | What it returns | Fetch it when | | ------------------------------------------- | ---------------------------------------- | ------------------------------------------- | | [`llms.txt`](https://you.com/docs/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](/docs/agents/docs-mcp-server) | 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](/docs/integrations/python-sdk) or REST | [Quickstart](/docs/quickstart). Framework setups are on [Integrations](/docs/integrations). | | Setting up a team IDE | [Product MCP](/docs/agents/mcp-server) | [Cursor](/docs/agents/agent-harnesses/cursor) and [Claude Code](/docs/agents/agent-harnesses/claude-code) install the [plugin](/docs/agents/plugins). Other clients use the server URL. | | Working in your own local session | [Skills](/docs/agents/skills) and [Agent Harnesses](/docs/agents/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/agents/mcp-server), [Docs MCP](/docs/agents/docs-mcp-server), or [x402](/docs/administration/machine-payments/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](/docs/choose-the-right-api) compares latency and price. | Capability | Use it when | | ----------------------------------------------------- | ----------------------------------------------------------------------- | | [Web Search API](/docs/guides/search) | Sources are unknown and you need ranked web or news results. | | [Contents API](/docs/guides/contents) | You already have the URL and need the page as Markdown or HTML. | | [Answer API](/docs/guides/answer) | You want one cited answer from a single search pass, called over REST. | | [Research API](/docs/guides/research) | The question needs several searches and a cited write-up. | | [Finance Research API](/docs/guides/finance-research) | 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`. | > **Note** > > 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`](https://www.npmjs.com/package/@youdotcom-oss/mcp), or the hosted server at `https://api.you.com/mcp`, when an agent should call the tools. Use the [Python SDK](/docs/integrations/python-sdk) when you want a typed client that tracks new API fields. The `@youdotcom-oss/sdk` package is deprecated.