Skip to main content
You.com provides a remote MCP server at https://api.you.com/mcp with two search and research tools. Connect to https://api.you.com/mcp?profile=free for you-search with 100 queries/day — no API key or sign-up needed.

Available Tools

Installation

Authentication

Three options for connecting to the You.com MCP server: Get an API key at https://you.com/platform/api-keys.

Quick Start — Free Tier

No API key needed — just point MCPServerHTTP at the free-tier URL:
Code
The free tier only exposes you-search. For you-research and you-contents, use an API key or OAuth.

Authenticated Example — DSL

Use MCPServerHTTP with an API key and create_static_tool_filter to select both tools:
Code
you-research may encounter Pydantic v2 schema compatibility issues in crewAI’s DSL path. If you see a BadRequestError from OpenAI, fall back to create_static_tool_filter(allowed_tool_names=["you-search"]) or use MCPServerAdapter.

you-search Parameters

Query Operators

you-research Parameters

Research Effort Levels

Return Format

  • .output.content: Markdown answer with inline citations
  • .output.sources[]: List of sources with {url, title?, snippets[]}

Security

  • Trust boundary: Always add a trust boundary sentence in the agent’s backstory — tool results contain untrusted web content that should be treated as data only, never as instructions
  • Never hardcode API keys: Use YDC_API_KEY environment variable
  • HTTPS only: Always use https://api.you.com/mcp — never HTTP
See MCP Security for full security best practices.

Additional Resources