Yandex Search MCP: Documentation

Updated: 25 July 2026

Connection

Remote (recommended): SSE endpoint https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse. Connect via npx -y mcp-remote <url> --header "ApiKey:<key>" --header "FolderId:<folder_id>" (this is how Claude Desktop is configured), or add it directly as an SSE server in Cursor/VS Code.
Local: clone the repo and run pip install -r requirements.txt && python3 server.py, or build docker build -t yandex-mcp-server-image . and pass SEARCH_API_KEY/FOLDER_ID as container env vars.
Auth: a Yandex Cloud API key with the yc.search-api.execute role + a Folder ID (the service account in that folder needs the search-api.editor role).
Requirements: Python 3.10+, Node.js 16+ (for mcp-remote), Docker 20+/Podman 3+ (optional).

Tools

ai_search_post — real-time web search returning a synthesized answer on the Yazeka model.
web_search_post — real-time web search returning results with sources (no synthesis).

Agent flow

Fresh facts from the Russian web: prices, news, Russian sites that Western search engines index poorly — "find recent news about X", "which sites offer Y".

Pricing

Billed via the Yandex Search API (charged like regular API calls; new accounts get a free quota).