Yandex Search MCP Server

This Model Context Protocol (MCP) server lets AI assistants like Claude and Cursor use the Yandex Search API for searching the web. Yandex Search enables LLM agents to safely and easily find up-to-date information on the internet.

Available Tools

The Yandex Search MCP server includes the following tools:

• ai_search_post Performs a real-time web search and returns an AI-generated answer based on the search results using Yandex Yazeka AI model.
• web_search_post: Performs a real-time web search and returns answer with sources

Getting API Key

To use this MCP server, you need to be a customer of Yandex Search API. Also you need a Yandex Search API key and folder id:

• API Key Documentation
  • Must include yc.search-api.execute scope.
• Folder ID Documentation
  • The service account in this folder must have search-api.editor role.

How to use Yandex Search MCP Remotely (recommended)

Yandex Search MCP URL for Remote Connection

https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse

How to Add Yandex Search MCP to Claude 🤖

1. Configure Claude Desktop to Recognize MCP Servers

Open the Claude Desktop app and enable Developer Mode from the top-left menu bar.

Once enabled, open Settings (also from the top-left menu bar) and navigate to the Developer Option.

Click the Edit Config button to open the claude_desktop_config.json file

2. Add Yandex Search MCP to Claude Desktop

Add the following text to your Claude Desktop configuration file:

{
  "mcpServers": {
    "yandexSearch": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse",
        "--header", "ApiKey:<your_api_key>",
        "--header", "FolderId:<your_folder_id>"
      ]
    }
  }
}

3. Restart Claude Desktop

For the changes to take effect:

1. Completely quit Claude Desktop (not just close the window)
2. Start Claude Desktop again
3. Click "Search and Tools" to verify that yandexSearch is enabled and running

How to Add Yandex Search MCP to Cursor 🤖

1. Configure Cursor to Recognize MCP Servers

Open Settings and navigate to Tools and Integrations in the left panel.

Click the Add Custom MCP button to create the mcp.json config file in cursor

2. Add Yandex Search MCP to Cursor

Add the following text to your Claude Desktop configuration file:

{
  "mcpServers": {
    "yandexSearch": {
      "type": "sse",
      "url": "https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse",
      "headers": {
        "ApiKey": "<your_api_key>",
        "FolderId": "<your_folder_id>"
      }
    }
  }
}

3. Find information on the web with yandexSearch

1. Verify the setup by typing the following text in the chat:

use yandexSearch to find information about the best AI Agent frameworks in 2025

2. Cursor will ask you to confirm that it should use yandexSearch, click the Run Tool button or press (⌘↵) to confirm.
3. You should see "called search-api_post" in the chat and the answer based on the web search results.

How to Add Yandex Search MCP to Visual Studio Code 🤖

1. Configure Visual Studio Code to Recognize MCP Servers

Enable the chat.mcp.enabled setting in VS Code to enable MCP support.

Add a .vscode/mcp.json file in your workspace to configure MCP servers for a workspace.

2. Add Yandex Search MCP to Visual Studio Code

Add the following text to your Claude Desktop configuration file:

{
  "mcpServers": {
    "yandexSearch": {
      "type": "sse",
      "url": "https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse",
      "headers": {
        "ApiKey": "<your_api_key>",
        "FolderId": "<your_folde

... [View full README on GitHub](https://github.com/yandex/yandex-search-mcp-server#readme)