MCP Server

Introduction

The You.com MCP Server is the fastest path from zero to web-grounded AI agents. Give your agents real-time access to the latest web information through the Model Context Protocol—no API key, no signup, no billing required to get started. Search current content, get up-to-date answers, and extract live web pages—whether in your IDE or deployed agentic workflows. Built on MCP to work everywhere your agents do—one integration, unlimited compatibility across IDEs, frameworks, and production systems.

Key Features:

• 🆓 Free to start — no API key, no signup, no billing configuration needed
• 🔍 Web and news search with advanced filtering
• 📄 Content extraction from URLs in markdown or HTML format
• 🚀 Multiple deployment options: Remote server (recommended) or local NPM package
• 🔑 Optional API key for higher rate limits
• 🌐 Works seamlessly with Windsurf, Claude Code, Cursor, VS Code, JetBrains, and other MCP-enabled IDEs

Getting started

Get up and running with the You.com MCP Server in three simple steps—no API key required:

Step 1: Choose your setup

You can discover this server in the Anthropic MCP Registry as io.github.youdotcom-oss/mcp, or configure it manually:

Step 2: Configure your client

Choose from Windsurf, Claude Code, Cursor, VS Code, JetBrains, or other supported editors. See the Setup guides below for IDE-specific configuration.

Standard configuration templates

Most MCP clients use one of these standard configuration formats. Start with the free tier—no API key needed:

Free tier (no API key):

Remote server (recommended):

1
{
2
  "mcpServers": {
3
    "ydc-server": {
4
      "type": "http",
5
      "url": "https://api.you.com/mcp"
6
    }
7
  }
8
}

Local NPM package:

1
{
2
  "mcpServers": {
3
    "ydc-server": {
4
      "command": "npx",
5
      "args": ["@youdotcom-oss/mcp"]
6
    }
7
  }
8
}

With API key (for higher rate limits):

Remote server:

1
{
2
  "mcpServers": {
3
    "ydc-server": {
4
      "type": "http",
5
      "url": "https://api.you.com/mcp",
6
      "headers": {
7
        "Authorization": "Bearer <your-api-key>"
8
      }
9
    }
10
  }
11
}

Local NPM package:

1
{
2
  "mcpServers": {
3
    "ydc-server": {
4
      "command": "npx",
5
      "args": ["@youdotcom-oss/mcp"],
6
      "env": {
7
        "YDC_API_KEY": "<your-api-key>"
8
      }
9
    }
10
  }
11
}

Step 3: Test your setup

Once configured, try these natural language queries with your AI assistant:

• “Search the web for the latest news about artificial intelligence”
• “What is the capital of France?” (with web search)
• “Extract the content from https://example.com”

Your AI assistant will ask for permission to use the You.com MCP tools the first time, then automatically use them for future requests.

Available tools

The You.com MCP Server provides two powerful tools that work seamlessly with your AI assistant. Simply ask in natural language what you want to do - your MCP client automatically handles the rest.

you-search

Comprehensive web and news search with advanced filtering capabilities. Use this when you need to search the web for information, filter by specific sites or file types, or get the latest news on a topic.

you-contents

Extract full page content from URLs in markdown or HTML format. Use this when you need to extract and analyze content from web pages for reading or processing in your workflow.

Use cases & examples

Here are practical examples showing how to use the You.com MCP tools in your daily workflow:

Research & information gathering

Finding specific information:

• “Find recent research papers about quantum computing on arxiv.org”
• “Search for TypeScript documentation about generics”
• “Get the latest news about renewable energy from the past week”
• “Find PDF files about machine learning algorithms”

Content extraction & analysis

Extracting web content:

• “Extract the content from this blog post: https://example.com/article”
• “Get the documentation from these three URLs in markdown format”
• “Pull the HTML content from this page preserving the layout”
• “Batch extract content from these 5 documentation pages”

Combined workflows

Your AI assistant can orchestrate multiple tools to complete complex tasks:

1. Research + extract: “Search for the best TypeScript tutorials, then extract the content from the top 3 results”
2. Question + deep dive: “What is WebAssembly? Then search for real-world examples and extract code samples”
3. News + analysis: “Find recent articles about AI regulation, then summarize the key points”

Pro tips

• Be specific: Include domains, date ranges, or file types when searching for more precise results
• Use natural language: You don’t need to memorize parameters - just describe what you want
• Ask follow-up questions: Refine results and dig deeper by asking your AI assistant to clarify or expand
• Let your agent orchestrate: For complex workflows, your AI assistant will automatically use multiple tools together

Setup guides

$
claude mcp add --transport http ydc-server https://api.you.com/mcp --header "Authorization: Bearer <your-api-key>"

$
code --add-mcp '{"name":"ydc-server","url":"https://api.you.com/mcp","type":"http","headers":{"Authorization":"Bearer <your-api-key>"}}'

Additional resources

For complete details on search parameters, response formats, and advanced usage, see the Search API Reference.

Troubleshooting

Report an issue

If you’re experiencing issues, we’re here to help:

• Email: [email protected]
• Web: You.com Support
• GitHub: Report an issue

For contributors

Interested in contributing to the You.com MCP Server? We’d love your help!

Need technical details? Check AGENTS.md for complete development setup, architecture overview, code patterns, and testing guidelines.

1. Fork the repository
2. Create a feature branch following naming conventions in CONTRIBUTING.md
3. Follow the code style guidelines and use conventional commits
4. Write tests for your changes (maintain >80% coverage)
5. Run quality checks: bun run check && bun test
6. Submit a pull request with a clear description

We appreciate all contributions, whether it’s:

• Bug fixes
• New features
• Documentation improvements
• Performance optimizations
• Test coverage improvements

Transport protocols

The MCP server supports two transport protocols:

Resources

Explore further