> 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. > Web Search, Answer, Contents, Research, and Finance Research APIs that give your AI app real-time web intelligence. Start with free credits. ## Docs - [MCP Server](https://you.com/docs/agents/mcp-server.md): Hosted MCP server for You.com web search, contents, research, and finance tools. One server, three POST endpoints. Enabled tools are the intersection of profile, allowlist, and path. - [Docs MCP Server](https://you.com/docs/agents/docs-mcp-server.md): Give any MCP-enabled agent a searchDocs tool that searches all of You.com's developer documentation—API references, guides, and code examples—in real time. No API key. - [Agent Skills](https://you.com/docs/agents/skills.md): Install You.com agent skills for current web search, URL content extraction, cited research, finance research, and integration discovery. - [Plugins](https://you.com/docs/agents/plugins.md): Install the You.com skills through your platform's native plugin system—Claude Code, Cursor, Codex, Copilot CLI, Kimi Code, Grok Build, OpenCode, OpenClaw, Pi, Hermes, and DeepSeek Harness. - [Agent Harnesses](https://you.com/docs/agents/agent-harnesses.md): Connect a coding agent to You.com. Web search, page fetch, and research cover docs, errors, and questions the model's training data does not. - [Claude Code](https://you.com/docs/agents/agent-harnesses/claude-code.md): Install the You.com plugin for Claude Code: four skills plus the You.com MCP servers for web search, page content, cited research, and finance research. Two commands, OAuth sign-in. - [Cursor](https://you.com/docs/agents/agent-harnesses/cursor.md): Install the You.com plugin for Cursor: four skills plus the You.com MCP servers for web search, page content, cited research, and finance research. Or add the MCP server alone. - [Factory Droid](https://you.com/docs/agents/agent-harnesses/factory-droid.md): Give Factory Droid real-time web search, content extraction, and citation-backed research through the You.com MCP Server. OAuth 2.1, API key, or free tier. - [Codex CLI](https://you.com/docs/agents/agent-harnesses/codex-cli.md): Install the You.com plugin for Codex CLI: four skills plus the You.com MCP servers for web search, research, and finance research. Or add the MCP server alone, with a free tier. - [OpenCode](https://you.com/docs/agents/agent-harnesses/opencode.md): Install the You.com plugin for OpenCode: four skills plus You.com MCP servers for web search, research, finance, and docs search. Or add the MCP server alone, with a free tier. - [Windsurf](https://you.com/docs/agents/agent-harnesses/windsurf.md): Give Windsurf's Cascade agent real-time web search, content extraction, and citation-backed research through the You.com MCP Server. - [Gemini CLI](https://you.com/docs/agents/agent-harnesses/gemini-cli.md): Give Gemini CLI real-time web search, content extraction, and citation-backed research through the You.com MCP Server. Free tier with no signup. - [VS Code](https://you.com/docs/agents/agent-harnesses/vscode.md): Give GitHub Copilot's agent mode real-time web search, content extraction, and citation-backed research through the You.com MCP Server. - [JetBrains IDEs](https://you.com/docs/agents/agent-harnesses/jetbrains.md): Give AI Assistant and Junie real-time web search, content extraction, and citation-backed research through the You.com MCP Server. - [Zed](https://you.com/docs/agents/agent-harnesses/zed.md): Give Zed's AI assistant real-time web search, content extraction, and citation-backed research through the You.com MCP Server. Free tier with no signup. - [Pi](https://you.com/docs/agents/agent-harnesses/pi.md): Install the You.com package for Pi: four skills plus six You.com MCP servers for web search, page content, research, finance, and docs lookup. Keyless search with no signup. - [Cecli](https://you.com/docs/agents/agent-harnesses/cecli.md): Give Cecli real-time web search, content extraction, and citation-backed research through the You.com MCP Server. Free tier with no signup. - [Jan](https://you.com/docs/agents/agent-harnesses/jan.md): Use You.com as Jan's web search provider—keyless out of the box, or with an API key for higher limits and extracted page content. Or connect the You.com MCP server for research and finance tools. - [DeepSeek Harness](https://you.com/docs/agents/agent-harnesses/deepseek-harness.md): Install the You.com plugin for DeepSeek Harness: You.com-backed web search, the You.com MCP servers, and three agent skills. Keyless search with no account, or an API key for the full tool set. - [GitHub Copilot CLI](https://you.com/docs/agents/agent-harnesses/copilot-cli.md): Install the You.com plugin for GitHub Copilot CLI: four skills plus the You.com MCP servers for web search, page content, cited research, and finance research. Or add the MCP server alone, with a free tier. - [Grok Build](https://you.com/docs/agents/agent-harnesses/grok-build.md): Install the You.com plugin for Grok Build: four skills plus the You.com MCP servers for web search, page content, cited research, and finance research. Or add the MCP server alone, with a free tier. - [Kimi Code](https://you.com/docs/agents/agent-harnesses/kimi-code.md): Install the You.com plugin for Kimi Code: four skills plus the You.com MCP servers for web search, page content, cited research, and finance research. Or add the MCP server alone, with a free tier. - [Hermes Agent](https://you.com/docs/agents/agent-harnesses/hermes.md): Install the You.com plugin for Hermes Agent: four skills plus the You.com MCP servers for web search, page content, cited research, and finance research. Or add the MCP server alone, with a free tier.