Yandex Maps MCP Server
An MCP server for Yandex Maps: forward and reverse geocoding and static map rendering with placemarks
Install
npm install
npm run buildRun 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 mapLimitations
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 | |
|---|---|
| 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.
Related
166 skills for scientific work: bioinformatics, cheminformatics, clinical data, geospatial analysis and 100+ databases
Google's open-source MCP server for databases: ready tools for Postgres, MySQL, BigQuery, Spanner and more, plus custom tools in tools.yaml
Official Hugging Face skills: Hub operations via the hf CLI, datasets, model training, Spaces, evals and deployment
A token-lean MCP server for PostgreSQL, MySQL, MariaDB, SQL Server and SQLite with a read-only mode