Agents
You.com runs two MCP servers with different URLs and different jobs.
Docs MCP vs Product MCP
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 guide and the MCP Server guide.
Pick an API
The five REST APIs are listed in the Quickstart. Open the overview that matches the job:
- Web Search API—ranked web and news JSON for your own pipeline
- Answer API—one-call cited Markdown from a single search
- Contents API—Markdown or HTML from URLs you already have
- Research API—multi-step cited answers with depth control
- Finance Research API—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 (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.