Docs MCP Server

View as MarkdownOpen in Claude

The You.com Docs MCP Server gives AI agents instant access to all of You.com’s developer documentation — API references, guides, code examples, and feature explanations — searchable in real time. Connect it to Claude Code, Cursor, VS Code, or any MCP-compatible client, and your agent can ask questions about You.com APIs and get accurate, sourced answers without leaving its workflow.

It is separate from the You.com API MCP Server, which searches the live web. This one searches these docs.

Server URL: https://you.com/docs/_mcp/server · Transport: streamable HTTP · Auth: none — publicly accessible, no API key

Available Tools

searchDocs

Search across the You.com developer docs to find relevant information, code examples, API references, and guides. Returns contextual passages with titles and direct links to the documentation pages.

PropertyValue
Tool namesearchDocs
Inputquery (string, required) — the search query
OutputMatching doc passages with source URLs
AccessRead-only, no API key

Setup

No authentication required. Add the server URL to your preferred AI tool.

Run this command in your terminal:

$claude mcp add --transport http fern_mcp_you-com-docs https://you.com/docs/_mcp/server

The server is available in all Claude Code sessions immediately.

Example Prompts

Once connected, ask your AI tool questions like:

  • “How do I use livecrawl with the Web Search API?”
  • “Show me the Python SDK quickstart.”
  • “What does the Research API output_schema parameter do?”
  • “How do I authenticate my API requests?”
  • “How do I filter Web Search results by date?”
  • “What’s the difference between the Contents API and livecrawl?”

Example Responses

Here is what searchDocs returns for a few real queries:

  • “how do I use livecrawl?” → Add livecrawl to any /v1/search request to attach full page content (markdown or html) to each result; markdown is recommended for LLMs. /docs/guides/retrieve-page-content
  • “Python SDK quickstart”pip install youdotcom, then You(YDC_API_KEY) and you.search.unified(query=...). /docs/sdks/python-sdk
  • “Research API output schema” → Pass output_schema in the request; the API returns typed JSON with content_type: "object". /docs/guides/research
  • “how do I authenticate my API requests?” → Pass an API key as the X-API-Key header (store it in YDC_API_KEY); get one at you.com/platform/api-keys. /docs/administration/api-keys
  • “filter search results by date” → Use the freshness parameter: day, week, month, year, or YYYY-MM-DDtoYYYY-MM-DD. /docs/guides/live-news

Every response includes a source URL pointing back to the exact documentation page, so your agent (or you) can verify the answer and read more.

When to Use It

Use the Docs MCP Server as a first step in You.com API discovery. Point your agent at this server, have it searchDocs for what you need, then use the You.com API MCP Server to run real searches, extractions, and research against the live web. The two servers are complementary — one searches the docs, the other searches the web.

Next Steps