Yandex Tools

v1.0.0Search & Data Extractionstable

MCP server for yandex tools

yandex-toolsmcpai-integration
Share:
27
Stars
0
Downloads
0
Weekly
0/5

What is Yandex Tools?

Yandex Tools is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for yandex tools

MCP server for yandex tools

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP server for yandex tools

Use Cases

Access Yandex services
altrr2

Maintainer

LicenseMIT
Languagejavascript
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx yandex-tools

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Yandex Tools

Yandex Tools MCP is a suite of four MCP servers that connect AI agents to Yandex's core developer and marketing APIs: Wordstat for keyword research and search trends, Search for web search, Webmaster for site analytics and indexing status, and Metrika for web traffic analytics. It is particularly useful for digital marketers, SEO professionals, and developers working with Russian-language search audiences who want to query Yandex data directly from their AI client.

Prerequisites

  • Node.js 18+ and npx installed
  • A Yandex Cloud account with API access enabled
  • YANDEX_SEARCH_API_KEY and YANDEX_FOLDER_ID for Wordstat and Search tools
  • YANDEX_WEBMASTER_TOKEN (OAuth) for Webmaster tools
  • YANDEX_METRIKA_TOKEN (OAuth) for Metrika analytics tools
1

Obtain Yandex API credentials

Log into Yandex Cloud (console.cloud.yandex.com) to get your API key and folder ID. For Webmaster and Metrika, generate OAuth tokens at oauth.yandex.com.

2

Add the Yandex Wordstat server to Claude Desktop

Add the wordstat MCP server entry to your claude_desktop_config.json with your API key and folder ID.

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "yandex-wordstat-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "your-api-key",
        "YANDEX_FOLDER_ID": "your-folder-id"
      }
    }
  }
}
3

Add the Yandex Search server

Optionally add the search server for AI-powered web search through Yandex.

{
  "mcpServers": {
    "yandex-search": {
      "command": "npx",
      "args": ["-y", "yandex-search-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "your-api-key",
        "YANDEX_FOLDER_ID": "your-folder-id"
      }
    }
  }
}
4

Add Yandex Webmaster for SEO data

Add the webmaster server using an OAuth token for site indexing, errors, and SEO analytics.

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": ["-y", "yandex-webmaster-mcp"],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "your-oauth-token"
      }
    }
  }
}
5

Add Yandex Metrika for traffic analytics

Add the Metrika server for web analytics, visitor data, and traffic source analysis.

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "npx",
      "args": ["-y", "yandex-metrika-mcp"],
      "env": {
        "YANDEX_METRIKA_TOKEN": "your-oauth-token"
      }
    }
  }
}
6

Restart Claude Desktop and begin querying

Restart Claude Desktop to load all configured Yandex servers, then start querying keyword volumes, search results, and analytics data.

Yandex Tools Examples

Client configuration

Full Claude Desktop config with all four Yandex MCP servers configured with their respective credentials.

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "yandex-wordstat-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "your-api-key",
        "YANDEX_FOLDER_ID": "your-folder-id"
      }
    },
    "yandex-webmaster": {
      "command": "npx",
      "args": ["-y", "yandex-webmaster-mcp"],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "your-webmaster-token"
      }
    },
    "yandex-metrika": {
      "command": "npx",
      "args": ["-y", "yandex-metrika-mcp"],
      "env": {
        "YANDEX_METRIKA_TOKEN": "your-metrika-token"
      }
    }
  }
}

Prompts to try

Example prompts for keyword research, SEO analysis, and traffic data using the Yandex tools suite.

- "What is the monthly search volume for 'купить ноутбук' in Yandex Wordstat?"
- "Search Yandex for the top 10 results for 'лучший хостинг 2024'"
- "Show me the indexing status and crawl errors for my site in Yandex Webmaster"
- "What are the top traffic sources for my site this month in Yandex Metrika?"
- "Analyze keyword trends for 'онлайн курсы' over the past 12 months"

Troubleshooting Yandex Tools

API key authentication fails for Wordstat or Search

Verify that YANDEX_SEARCH_API_KEY and YANDEX_FOLDER_ID are correct in your config. The folder ID is found in Yandex Cloud Console under your cloud resource folder settings. Ensure the API key has the required roles (search.editor or similar).

OAuth token for Webmaster or Metrika is rejected

OAuth tokens expire. Generate a new token at oauth.yandex.com, selecting the correct scopes: webmaster:read for Webmaster and metrika:read for Metrika. Update the token in your MCP config and restart Claude Desktop.

npx fails to find the package

Try installing globally first with 'npm install -g yandex-wordstat-mcp' (or the relevant package name) and then use the installed command instead of npx in the config args.

Frequently Asked Questions about Yandex Tools

What is Yandex Tools?

Yandex Tools is a Model Context Protocol (MCP) server that mcp server for yandex tools It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Yandex Tools?

Follow the installation instructions on the Yandex Tools GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Yandex Tools?

Yandex Tools works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Yandex Tools free to use?

Yes, Yandex Tools is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

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.

Quick Config Preview

{ "mcpServers": { "yandex-tools": { "command": "npx", "args": ["-y", "yandex-tools"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Yandex Tools?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides