SkillFoxx

2GIS MCP

2GIS MCP (mapgl-mcp-server)

2GIS's official MCP server: place search, geocoding, routes, isochrones and static maps via the 2GIS APIs, needs a key from the Platform Manager

  • 6 ★ on the repository
  • Last commit
MCP serverOfficialEditors’ pick

Extended access

Why this level

  • A local server calls the 2GIS APIs: places, routes, geocoding
  • Uses the MAPGL_API_KEY and ROUTING_API_KEY quota and only reads data
All reasons and checks
Russian stack

2gis/2gis-mcpAuthor:2GIS

Install

Services

Manual install

git clone https://github.com/2gis/2gis-mcp.git && cd 2gis-mcp && npm install && npm run build

The package is not published on npm; build it from source per the repository's package.json.

Access and checks

How we review

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

  • A local server calls the 2GIS APIs: places, routes, geocoding
  • Uses the MAPGL_API_KEY and ROUTING_API_KEY quota and only reads data

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

What it does

The server gives the agent six tools on top of the 2GIS APIs. search_poi finds places and businesses by query near a point (Places API and Geocoder API), calculate_route builds a route for different transport types with time and distance (Routing API), geocode and reverse_geocode convert addresses to coordinates and back (Geocoder API), create_map_view renders a static PNG map with markers, lines and polygons (Static API), and calculate_isochrone builds the area reachable from a point within a given time (Isochrone API). The maps and search key goes into MAPGL_API_KEY, the routing and isochrone key into ROUTING_API_KEY; with a single shared key you set it in both variables.

Who it is for. For developers and analysts who need 2GIS maps, place search and routing for Russian and CIS cities right inside an agent.

Good fit when

  • You need to find businesses of a certain type near a map point
  • You need a route between addresses or coordinates
  • You want to try the 2GIS APIs from an agent on a free demo key

Not a fit when

  • You don't want to build the server from source: 2GIS also runs a cloud MCP server at mcp-2gis.api.2gis.com/mcp
  • You need sustained load without a subscription: the demo key lasts 30 days and has request limits

Example request

Find coffee shops within 500 meters of Red Square and build a walking route to the nearest one

MCP

Transport
stdio
Authentication
API key

Environment variables

MAPGL_API_KEY required, secret
2GIS API key for maps and search: Places API, Geocoder API, Static API.
ROUTING_API_KEY secret
2GIS API key for navigation: Routing API and Isochrone API, can be the same key.

Limitations

The package is not published on npm; install by cloning the repository and building it with npm run build. The repository README is short; the tools, keys and agent setup are documented on docs.2gis.com. You need a key from the Platform Manager account: the free demo key lasts 30 days and has request limits, after that a subscription is required, at the same rates as direct 2GIS API calls. The code is under a proprietary 2GIS license. The repository has no releases, 4 ★ repository stars as of 04.10.2026.

How to disable. Remove the server block from your MCP client config and stop the node process.

FAQ

Where do I get a key?

Sign up in the 2GIS Platform Manager account and get a free 30-day demo key, which already includes every API the MCP server needs. Ongoing use requires a subscription.

Why don't routes work?

calculate_route and calculate_isochrone read the key from ROUTING_API_KEY. If you have one key for all APIs, set it in both MAPGL_API_KEY and ROUTING_API_KEY.

Discussion

No questions or reviews yet.

All 2GIS tools

2GIS MCP

@theyahia/2gis-mcp

Russian stack

2GIS API MCP server: place search, geocoding, routes, public transport, address suggestions and ratings

MCP serverExtended access4
Russian stack

A community MCP server on top of the 2GIS search API: places, geocoder, suggestions, categories and regions, your own 2GIS key and Docker Compose

MCP serverExtended access1
Russian stack

A small MCP prototype on top of 2GIS's MapGL JS API, giving an LLM map access for queries like comparing districts by cafe density

MCP serverExtended access
Russian stack

A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data

MCP serverBroad access38
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 access3

README in short

The repository README is a single paragraph: name, purpose and a link to the docs.2gis.com documentation. The docs describe the local server's six tools, the 2GIS API behind each, the MAPGL_API_KEY and ROUTING_API_KEY variables, and setup for Claude Desktop, Cursor, VS Code and LM Studio. The repository ships a proprietary 2GIS license in Russian and English.

README badge

Report a problem