Yandex Search MCP Server
Enables AI assistants to perform real-time web searches and retrieve AI-generated answers using the Yandex Search API. It provides tools for accessing up-to-date internet information with support for both raw search results and summarized content via
What is Yandex Search MCP Server?
Yandex Search MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai assistants to perform real-time web searches and retrieve ai-generated answers using the yandex search api. it provides tools for accessing up-to-date internet information with support for ...
Enables AI assistants to perform real-time web searches and retrieve AI-generated answers using the Yandex Search API. It provides tools for accessing up-to-date internet information with support for both raw search results and summarized content via
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables AI assistants to perform real-time web searches and
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx yandex-search-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Yandex Search MCP Server
The Yandex Search MCP Server enables AI assistants to perform real-time web searches using the Yandex Search API, delivering both raw search results with sources and AI-generated summarized answers powered by the Yandex Yazeka model. It exposes two tools — web_search_post for retrieving annotated search results with URLs and snippets, and ai_search_post for obtaining a synthesized AI answer grounded in live web content. Teams and developers use it to give their AI workflows access to current internet information, particularly useful for Russian-language content and Eastern European markets where Yandex has strong indexing coverage. The server can be used as a hosted remote endpoint (no local install required) or run locally via Python or Docker.
Prerequisites
- A Yandex Cloud account with Yandex Search API access enabled
- A Yandex Search API key with the yc.search-api.execute scope
- A Yandex Cloud Folder ID where your service account has the search-api.editor role
- Python 3.10+ if running locally, or Docker 20+ for containerized deployment
- An MCP-compatible client such as Claude Desktop, Cursor, or VS Code with Copilot
Obtain Yandex Search API credentials
Log in to Yandex Cloud, create or select a folder, create a service account with the search-api.editor role, generate an API key with the yc.search-api.execute scope, and note your Folder ID.
Option A: Connect to the hosted remote endpoint (no install)
The easiest approach is to use Yandex's hosted SSE endpoint. Add this configuration to Claude Desktop — no local server installation needed. Replace the placeholder values with your actual API key and Folder ID.
{
"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>"
]
}
}
}Option B: Run locally with Python
Clone the repository, install Python dependencies, and run the server locally for full control over the deployment.
git clone https://github.com/yandex/yandex-search-mcp-server.git
cd yandex-search-mcp-server
pip install -r requirements.txt
export SEARCH_API_KEY=<your_api_key>
export FOLDER_ID=<your_folder_id>
python3 server.pyConfigure for local Python server in Claude Desktop
If running locally with Python, use this configuration in your Claude Desktop config file instead of the remote endpoint.
{
"mcpServers": {
"yandex-search-api": {
"type": "stdio",
"command": "env",
"args": [
"SEARCH_API_KEY=<your_api_key>",
"FOLDER_ID=<your_folder_id>",
"python3",
"/path/to/yandex-search-mcp-server/server.py"
]
}
}
}Restart Claude Desktop and verify
Fully quit and relaunch Claude Desktop. Click 'Search and Tools' and confirm that yandexSearch (or yandex-search-api) appears and is enabled.
Yandex Search MCP Server Examples
Client configuration (Claude Desktop — hosted endpoint)
Connect Claude Desktop to the Yandex Search MCP Server using the official hosted SSE endpoint. This requires no local installation.
{
"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>"
]
}
}
}Prompts to try
Example prompts that use the web_search_post and ai_search_post tools via the Yandex Search MCP Server.
- "Use yandexSearch to find the latest news about AI regulation in Europe."
- "Search for the best AI agent frameworks available in 2025 and summarize the top three."
- "What were the results of the most recent Russian presidential election? Use web search."
- "Find recent developer tutorials for FastAPI and list their URLs."
- "Use AI search to explain what happened with the Yandex spinoff and its impact."Troubleshooting Yandex Search MCP Server
Authentication errors: 'Unauthorized' or '403 Forbidden' from the Yandex API.
Verify that your SEARCH_API_KEY includes the yc.search-api.execute scope and that the service account in your FOLDER_ID has the search-api.editor role. API keys are folder-scoped in Yandex Cloud — ensure the folder ID matches the one where the service account resides.
npx mcp-remote cannot connect to the hosted SSE endpoint.
Ensure Node.js 16+ and npx are installed. The --header flag syntax requires mcp-remote version 0.1.0 or newer. Run 'npx -y mcp-remote --version' to check. If the hosted endpoint is unreachable, fall back to running the server locally with Python.
server.py fails to start locally with 'ModuleNotFoundError'.
Run 'pip install -r requirements.txt' from the repository root to install all dependencies. If using a virtual environment, ensure it is activated before running the server. Check that Python 3.10+ is being used with 'python3 --version'.
Frequently Asked Questions about Yandex Search MCP Server
What is Yandex Search MCP Server?
Yandex Search MCP Server is a Model Context Protocol (MCP) server that enables ai assistants to perform real-time web searches and retrieve ai-generated answers using the yandex search api. it provides tools for accessing up-to-date internet information with support for both raw search results and summarized content via It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Yandex Search MCP Server?
Follow the installation instructions on the Yandex Search MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Yandex Search MCP Server?
Yandex Search MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Yandex Search MCP Server free to use?
Yes, Yandex Search MCP Server is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
Yandex Search MCP Server Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Yandex Search MCP Server? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Yandex Search MCP Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Yandex Search MCP Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.