home / mcp / you.com mcp server

You.com MCP Server

Official You.com MCP Server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "brainsparker-youdotcom-mcp-server": {
      "url": "https://api.you.com/mcp",
      "headers": {
        "YDC_API_KEY": "<you-api-key>"
      }
    }
  }
}

You.com MCP Server provides web and news search capabilities by connecting to the You.com Search API. It can run in two modes: as a remote HTTP MCP server that you access over the network, or as a local stdio MCP server you run on your machine. This flexibility lets you integrate You.com search into your MCP client workflows with secure API key authentication and Bun-based performance.

How to use

Choose your preferred transport and configure your MCP client to connect to the You.com MCP Server. You have two options: use the remote hosted server over HTTP, or run a local MCP server via a local package manager. In either case you can perform web and news searches, apply site and file type filters, specify languages, and include exact or excluded terms to refine results. Ensure you provide your You.com API key for authenticated access when using the HTTP transport.

How to install

Prerequisites you need before starting:

- Bun 1.2.21 or higher
- You.com API key

Additional configuration and usage notes

You can connect to You.com MCP in two ways. The HTTP remote server requires an API key and uses a Bearer token in the Authorization header. The local stdio option runs a local MCP server using your environment variables.

Configuration examples

{ 
  "mcpServers": {
    "ydc-search": {
      "type": "http",
      "url": "https://api.you.com/mcp",
      "headers": {
        "Authorization": "Bearer <you-api-key>"
      }
    }
  }
}

{ 
  "mcpServers": {
    "ydc-search": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": {
        "YDC_API_KEY": "<you-api-key>"
      }
    }
  }
}

Troubleshooting and tips

If you encounter authentication errors, double-check that your API key is correctly set in the HTTP headers or environment variables. For local development, ensure Bun is installed and the environment variable YDC_API_KEY is loaded in your shell or .env file.

Available tools

you-search

Performs a comprehensive web and news search using the You.com Search API, supporting filters for site, file type, language, exact terms, and exclusions.