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

Local serverstdioPython

What is the Yandex Search MCP server?

Yandex search mcp server lets Claude, Cursor and other MCP clients work with Yandex Search directly. 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.

What Yandex Search does

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.

Tools it exposes

Once connected, the assistant can call these 3 tools directly:

  • web_search_post — Performs a real-time web search and returns answer with sources
  • Prerequisites — The Prerequisites tool exposed by this server
  • Installation — The Installation tool exposed by this server

Installing the yandex search mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Configuration

Before the server will start you need to supply 2 environment variables: SEARCH_API_KEY, FOLDER_ID. Keep credentials in your client's env block or a secrets manager rather than committing them.

Requirements

  • Python 3.10+ - Node.js 16+ (for MCP development) - Docker 20+ or Podman 3+ (for containerized deployment)

Where it fits

Search and scraping servers exist to fix the single most common failure of any assistant: answering from stale training data instead of what is on the web today. Yandex Search sits in that group, and the shape of its toolset — web_search_post, Prerequisites, Installation — tells you what it is really for. Worth comparing against the other search web scraping servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • It will not start until its required credentials are present, so set those before wondering why the tools never appear.
  • Maintained by yandex, written in Python.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the yandex search mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
web_search_postPerforms a real-time web search and returns answer with sources
PrerequisitesThe Prerequisites tool exposed by this server.
InstallationThe Installation tool exposed by this server.

How to install the Yandex Search MCP server

{
  "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>"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Python 3.10+ - Node.js 16+ (for MCP development) - Docker 20+ or Podman 3+ (for containerized deployment)
VariableDescriptionRequired
SEARCH_API_KEYCredential the server authenticates with.Yes
FOLDER_IDConfiguration value read at startup.Optional

Example prompts to try

  • Use Yandex Search to web search post.
  • Use Yandex Search to Prerequisites.
  • Use Yandex Search to Installation.

Frequently asked questions

It connects Yandex Search to MCP-compatible AI assistants such as Claude and Cursor, exposing 3 tools (web_search_post, Prerequisites, Installation) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Yandex Search directly.