Yandex Search MCP

io.github.stufentlyPublished by GitHub account stufentlyv2.2.1Updated Oct 24, 2026

MCP server for Yandex Search API (v2, Cloud)

VerifiedSTDIODesktop onlyWeb Search & Scraping

Overview

AI-generated overview

Local MCP server that lets an assistant run web searches through the Yandex Search API v2 and get ranked, structured results.

What you can do
  • Search the web with a query, optional result count (1-100), region ID, page number and safe-search mode.
  • Read structured results: position, URL, domain, title, headline, passages, snippet, size, language and cached URL.
  • Automatic index selection: Cyrillic queries use the Russian index, Latin-only queries the international one.
  • Retries automatically with exponential backoff on rate-limit and server errors.
When to use it
Useful when an assistant needs web search results from Yandex, especially for Russian-language or region-specific queries, and you already have a Yandex Cloud account.
Requirements
Runs as a local Node.js process (package @stufently/yandex-search-mcp; the README says to clone the repo and run it from source with bun install). Needs a Yandex Cloud API key in YANDEX_SEARCH_API_KEY and a folder ID in YANDEX_FOLDER_ID; the service account needs the search-api.webSearch.user role. Network access to the Yandex Cloud search endpoint.
Before you install
Requires a Yandex Cloud API key (YANDEX_SEARCH_API_KEY) that is passed in the client config environment; keep it out of shared configs. Search queries and results are sent to Yandex Cloud. The README warns that the unscoped npm name yandex-search-mcp belongs to an unrelated publisher, so install only the scoped package.

Installation

In SourceWeft

  1. Open Yandex Search MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

yandex-search-mcp

MCP server for Yandex Search API v2 (Cloud). Search the web through Yandex and get structured results with titles, snippets, URLs, and metadata.

Installation

This package is published as @stufently/yandex-search-mcp; the unscoped name yandex-search-mcp belongs to an unrelated publisher (see the note in the root README). Nothing is on the scope yet, so run it from source:

bash
git clone https://github.com/stufently/yandex-mcp.gitcd yandex-mcp && bun installnode packages/yandex-search-mcp/src/index.mjs

Configuration

Add to your MCP client config:

json
{  "mcpServers": {    "yandex-search": {      "command": "node",      "args": ["/path/to/yandex-mcp/packages/yandex-search-mcp/src/index.mjs"],      "env": {        "YANDEX_SEARCH_API_KEY": "your-api-key",        "YANDEX_FOLDER_ID": "your-folder-id"      }    }  }}

Environment Variables

VariableRequiredDescription
YANDEX_SEARCH_API_KEYYesAPI key from Yandex Cloud Console
YANDEX_FOLDER_IDYesFolder ID from Yandex Cloud

No OAuth flow is needed. Get both values from the Yandex Cloud Console.

Tool Reference

search

Search the web using Yandex Search API. Returns ranked results with titles, snippets, and URLs.

Parameters:

ParameterTypeRequiredDefaultDescription
querystringYes--Search query text
maxResultsnumberNo10Maximum results to return (1-100)
regionnumberNo--Yandex region ID
pagenumberNo0Page number (0-based)
familyModeenumNoFAMILY_MODE_MODERATESafe search: FAMILY_MODE_NONE, FAMILY_MODE_MODERATE, FAMILY_MODE_STRICT

Response fields:

Each result contains:

FieldTypeDescription
positionnumberRanking position (1-based)
urlstringResult URL
domainstringHostname extracted from URL
titlestringPage title
headlinestringMeta description
passagesstring[]Relevant text passages
snippetstringCombined headline and passages
sizenumberDocument size in bytes
langstringDocument language
cachedUrlstringYandex cached copy URL

Language detection:

The search type and localization are automatically selected based on the query. Queries containing Cyrillic characters use the Russian search index; Latin-only queries use the international index.

API Details

  • Endpoint: POST https://searchapi.api.cloud.yandex.net/v2/web/search
  • Auth: Api-Key header
  • Response: JSON with base64-encoded XML in rawData field
  • Automatic retry with exponential backoff on 429/5xx errors

License

MIT

Source: packages/yandex-search-mcp/README.md at commit bdd6c64

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v2.2.1LatestOct 16, 2026
  2. v2.2.0Oct 15, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts