Yandex Maps MCP Server

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

  • 16 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Calls Yandex APIs with the user's keys
  • Without MCP_AUTH_TOKEN, HTTP mode has no authentication
All reasons and checks
Russian stack

peschinskiy/yandex-maps-mcp

Install

Services

Manual install

npm install
npm run build

Run inside a clone of the repository.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

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

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

MCP

Transport
stdio, http
Authentication
API key

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

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.

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.

Discussion

No questions or reviews yet.

Russian stack

An MCP server for pre-project land analysis: Rosreestr boundaries, Yandex geocoding and maps, infrastructure and geometry

MCP serverExtended access4Repository stars
Russian stack

Monorepo of Yandex MCP servers: Direct, Metrica, Webmaster, Wordstat, Tracker, 360, Maps, SpeechKit, YandexGPT and AppMetrica

MCP serverBroad access10Repository stars
Russian stack

A reference and recipe skill for the Yandex Maps JS API v3: markers, clustering, search, geocoding and React/Next.js, plus the coordinate-order gotcha

SkillMinimal access1Repository stars
Russian stack

An MCP server that fuses three transit sources, Mosgortrans, the Moscow region RNIS system and Yandex Transport, reconciling arrival predictions

MCP serverExtended access
Russian stack

A local SEO audit skill for the CIS market: business cards in Google Business Profile, Yandex Business, Yandex Maps, 2GIS and their consistency

SkillExtended access3Repository stars

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.

README badge

Report a problem

Foxx AIYandex Maps MCP Server
Foxx AI

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.