Yandex Maps MCP Server

An MCP server for Yandex Maps: forward and reverse geocoding and static map rendering with placemarks

MCP serverMedium riskRussian stack

peschinskiy/yandex-maps-mcp

Install

npm install
npm run build

Run inside a clone of the repository.

This is third-party code. Review the repository files before installing.

What it does

The server gives an agent three tools. One converts an address split into country, city, street and house into coordinates, another does the reverse. The third renders a PNG map from a center and span in degrees and can add placemarks. It runs over stdio or as a stateless HTTP server with an optional Bearer token, which suits n8n.

Who it is for. For developers and analysts who need address coordinates or map images inside an agent.

Good fit when

  • You need coordinates for a list of addresses
  • You want to show points on a map in the agent's reply
  • You want to connect the Yandex geocoder to an n8n workflow

Not a fit when

  • You need to find businesses by name: the Places API is not supported
  • You need interactive maps or routing

Example request

Find coordinates for Kazan, Baumana street 1 and show it on a map

Limitations

Requires two keys from the Yandex developer dashboard: one for JavaScript API and Geocoder, one for Static API. Business search is not supported because that API has no free tier. There is no public npm package, so the server is built from source. Last updated in November 2025.

How to disable. Remove the yandex-maps entry from your MCP client config.

MCP

Transport
stdio, http
Authentication
API key
Environment variables
Environment variables
YANDEX_MAPS_API_KEY
required, secret
JavaScript API and Geocoder key
YANDEX_MAPS_STATIC_API_KEY
required, secret
Static API key
MCP_TRANSPORT
http for HTTP mode, stdio by default
MCP_AUTH_TOKEN
secret
Bearer token protecting HTTP mode

Security check

  • Calls Yandex APIs with the user's keys
  • Without MCP_AUTH_TOKEN, HTTP mode has no authentication

README in short

The README describes three tools and their inputs, how to get two keys in the Yandex developer dashboard and a local build. It gives a Claude Desktop config, HTTP mode with port and token variables, and n8n settings. The limitations section explains the missing business search. MIT licensed.

FAQ

Why can't the agent find a cafe by name?

The server only geocodes known addresses and coordinates. Get the business address from the user, web search or another MCP.

Editors’ pick

166 skills for scientific work: bioinformatics, cheminformatics, clinical data, geospatial analysis and 100+ databases

SkillMedium risk44.9K
Editors’ pick

Google's open-source MCP server for databases: ready tools for Postgres, MySQL, BigQuery, Spanner and more, plus custom tools in tools.yaml

MCP serverHigh risk16.4K
Editors’ pick

Official Hugging Face skills: Hub operations via the hf CLI, datasets, model training, Spaces, evals and deployment

SkillHigh risk11K
Editors’ pick

A token-lean MCP server for PostgreSQL, MySQL, MariaDB, SQL Server and SQLite with a read-only mode

MCP serverHigh risk3.5K