Yandex Search MCP

● Active

io.github.stufently/yandex-search-mcp

MCP server for Yandex Search API (v2, Cloud)

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "yandex-search-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@stufently/yandex-search-mcp@2.3.0"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<your YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<your YANDEX_FOLDER_ID>"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env YANDEX_SEARCH_API_KEY='<your YANDEX_SEARCH_API_KEY>' --env YANDEX_FOLDER_ID='<your YANDEX_FOLDER_ID>' --transport stdio yandex-search-mcp -- npx -y @stufently/yandex-search-mcp@2.3.0
OpenAI Codex CLI
codex mcp add yandex-search-mcp --env YANDEX_SEARCH_API_KEY='<your YANDEX_SEARCH_API_KEY>' --env YANDEX_FOLDER_ID='<your YANDEX_FOLDER_ID>' -- npx -y @stufently/yandex-search-mcp@2.3.0
VS Code
code --add-mcp '{"name":"yandex-search-mcp","type":"stdio","command":"npx","args":["-y","@stufently/yandex-search-mcp@2.3.0"],"env":{"YANDEX_SEARCH_API_KEY":"<your YANDEX_SEARCH_API_KEY>","YANDEX_FOLDER_ID":"<your YANDEX_FOLDER_ID>"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • YANDEX_SEARCH_API_KEYrequiredsecretYandex Cloud API key (service account with search-api.webSearch.user)
  • YANDEX_FOLDER_IDrequiredYandex Cloud folder ID

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Search & Web
Version
2.3.0
Registry
active
Published
11/10/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 18, 2026

Looks healthy: Yandex Search MCP is maintained, open source.

Maintained
Active
Last commit 8 days ago (Nov 14, 2026), 0 open issues.
Official registry
Active
Published as io.github.stufently/yandex-search-mcp in the official MCP registry, version 2.3.0.
Source
Open source, MIT
Public repository under the MIT licence, 21 stars, 1 forks.
Runs
On your machine
A local npm package started by your client; it can reach whatever your user account can.
Credentials
2 required
Declared environment variables: YANDEX_SEARCH_API_KEY, YANDEX_FOLDER_ID. They stay on your machine; the config on this page shows where each goes.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 18, 2026
Stars
21
Forks
1
Last push
Nov 14, 2026
License
MIT

JavaScriptai-toolsclaude-codejavascriptkeyword-researchmcpmcp-servermetrikamodel-context-protocolnodejsseowebmasterwordstatyandexyandex-directyandex-metrika

From the README

Yandex MCP Unofficial project, not affiliated with or endorsed by Yandex. "Yandex" and the names of its services are trademarks of their owner and are used here only to describe which APIs the servers talk to. A monorepo of MCP (Model Context Protocol) servers for Yandex APIs. Provides AI assistants with access to Yandex Search, Wordstat, Webmaster, Metrika, and Direct through a unified interface. Built for Russian and CIS market analysis -- keyword research, search analytics, site monitoring, web traffic insights, and ad campaign management. Packages 94 tools total across all packages (counted by node scripts/smoke-tools.mjs). Package names. The packages go to npm under the @stufently/* scope (@stufently/yandex-webmaster-mcp and so on), starting with v2.2.0. The unscoped names — yandex-search-mcp, yandex-wordstat-mcp, yandex-webmaster-mcp, yandex-metrika-mcp — belong to a different publisher on the public registry (altrr2, altrr2/yandex-tools-mcp, first published 2025-12-20, three months before this repo existed). Never npx an unscoped name with your Yandex tokens in the environment: that hands your credentials to unrelated code. Always type the @stufently/ prefix. Install Paste this into a terminal. It starts the Webmaster server on stdin; the same npx command is what every client block below runs. Node.js >= 22 is the only prerequisite — no clone, no Bun, no build step.…

Read the full README on GitHub →

The most-starred Search & Web servers in the index, with their live-check result.

ServerStarsLast pushLive check
Browser Use121,623Nov 2026Working
Scrapling MCP Server104,822Nov 2026Local / not checked
Chrome DevTools MCP58,028Nov 2026Local / not checked
Chrome DevTools MCP58,014Nov 2026Local / not checked
com.puter MCP Server44,182Nov 2026Needs sign-in

Yandex Search MCP: questions people ask

Is Yandex Search MCP a remote or a local MCP server?
According to its entry in the official MCP registry, Yandex Search MCP ships as a local package (npm) that your client starts on your machine.
Does Yandex Search MCP need an API key?
Its registry entry declares 2 required environment variables: YANDEX_SEARCH_API_KEY, YANDEX_FOLDER_ID. The config on this page shows where each goes.
Is Yandex Search MCP safe to use?
Looks healthy: Yandex Search MCP is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: On your machine; credentials: 2 required. Serverdex check of Nov 18, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Yandex Search MCP still maintained?
Active: the repository's last commit 8 days ago. Last push Nov 14, 2026, 21 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
How do I add Yandex Search MCP to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
  1. Yandex Direct MCPMCP server for Yandex Direct API v5 — campaigns, ads, keywords, reports★ 21
  2. Yandex Metrika MCPMCP server for Yandex Metrika API — web analytics, traffic, audience data★ 21
  3. Yandex Webmaster MCPMCP server for Yandex Webmaster API — site analytics, indexing, search queries★ 21
  4. Yandex Wordstat MCPMCP server for Yandex Wordstat API — keyword research for Russian/CIS markets★ 21
Browse all Search & Web →

Add the badge to your site

Show visitors that Yandex Search MCP is listed here — it’s also the link we check for a free listing.

Yandex Search MCP — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-stufently-yandex-search-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Yandex Search MCP — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Yandex Search MCP — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-stufently-yandex-search-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-stufently-yandex-search-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-stufently-yandex-search-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-stufently-yandex-search-mcp)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-stufently-yandex-search-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-stufently-yandex-search-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-stufently-yandex-search-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).