Yandex Maps MCP Server

Name: Yandex Maps MCP Server
Author: peschinskiy

@peschinskiy

Repository

About Yandex Maps MCP Server

MCP server for Yandex Maps map rendering and geocoding APIs

#maps #mcp #yandex-maps #static-maps

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "yandex-maps-mcp": {
      "command": "node",
      "args": [
        "dist/index.js"
      ]
    }
  }
}

Tools

`country` (string) - The country name

location, formatted_address, address_components

`latitude` (number)

location, formatted_address, address_components

`latitude` (number) - Latitude coordinate of map center

PNG image of the map

Overview

What is Yandex Maps MCP Server?

A Model Context Protocol server that integrates with the Yandex Maps API, allowing AI assistants (like Claude) to geocode addresses, reverse geocode coordinates, and render static map images. It is aimed at developers building location-aware workflows with LLMs via MCP.

How to use Yandex Maps MCP Server?

Obtain Yandex JavaScript/Geocoder and Static API keys from the Yandex Developer portal. Install dependencies (npm install), build (npm run build), and set the YANDEX_MAPS_API_KEY and YANDEX_MAPS_STATIC_API_KEY environment variables. Run locally via node dist/index.js or add to Claude Desktop’s claude_desktop_config.json for stdio. For remote access, set MCP_TRANSPORT=http and optionally MCP_PORT and MCP_AUTH_TOKEN.

Key features of Yandex Maps MCP Server

Convert an address to geographic coordinates (maps_geocode)
Convert coordinates to a readable address (maps_reverse_geocode)
Render a map as a PNG image (maps_render)
Display optional placemarks on rendered maps
Supports both stdio and HTTP transport modes
Stateless HTTP server with optional Bearer token authentication

Use cases of Yandex Maps MCP Server

Geocode a known address to obtain latitude/longitude for further analysis
Convert GPS coordinates into a human-readable location description
Generate a static map image centered on a location with custom placemarks
Automate geocoding tasks in a workflow via the HTTP server (e.g., in n8n)
Combine with web search or user input to geocode addresses discovered by the model

FAQ from Yandex Maps MCP Server

What API keys are required?

Two Yandex API keys are needed: one for “JavaScript and Geocoder API” (used by geocoding tools) and one for Static API (used for map rendering).

What transport modes does the server support?

It supports stdio transport for local desktop use and Streamable HTTP transport for remote access and web-based clients like n8n.

Does the HTTP server support authentication?

Yes. Setting the MCP_AUTH_TOKEN environment variable enables Bearer token authentication. If not set, the server runs without authentication (not recommended for production).

What are the known limitations of this server?

The Yandex Maps Places API has no free tier, so the server cannot retrieve organization addresses or coordinates. It can only geocode places whose addresses or coordinates are already known to the model (e.g., from user input or web search).