Advertise
MCP.so
Sign In

Yandex Maps MCP Server

@peschinskiy

Repository

Basic information

Category

Media & Design

License

MIT

Transports

stdio

Author

peschinskiy

About Yandex Maps MCP Server

MCP server for Yandex Maps map rendering and geocoding APIs

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

Yandex Maps MCP Server config

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

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

Yandex Maps MCP Server tools

6

`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

Frequently asked questions

1

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).

2

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.

3

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).

4

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).

5

Is the HTTP server stateful?

No, the HTTP server is explicitly stateless.

Comments

More Media & Design MCP servers

JSON2Video

JSON2Video

Official JSON2Video MCP server. Video API for automated video production at scale: render videos from templates with AI voiceovers, subtitles and AI images. Remote server with OAuth (https://mcp.json2video.com/mcp) or lo

A

AdvisorIQ

Continuing education rules for US financial advisors (CFP, CFA, IWI, IAR by state, FINRA, American College) with official sources and verified dates, plus firm-level data, national and state rankings and market stats on

P

Photo Mosaic & AI Collage Maker - Collager.ai

Collager.ai

Photo mosaic maker and AI photo collage maker: turn your own photos into a photo mosaic - one picture made of hundreds of your photos - or into a heart, number or word photo collage in seconds. No sign-in or API key need

TravelAnimator

Lascade-Co

MCP server and CLI for TravelAnimator — generate animated travel videos, itineraries, and trip media from Claude, Codex, or your terminal

EmbedSocial

Connect Claude, ChatGPT, and other AI assistants to your social media content, reviews, and UGC aggregated via EmbedSocial.

Advertise