2GIS MCP
@theyahia/2gis-mcp
2GIS API MCP server: place search, geocoding, routes, public transport, address suggestions and ratings
- 4 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Calls the external 2GIS API and spends key quota
- Some data comes from an undocumented endpoint
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/theyahia-2gis-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Calls the external 2GIS API and spends key quota
- Some data comes from an undocumented endpoint
This is third-party code. Review the repository files before installing.
What it does
The server gives the agent nine 2GIS tools, all read-only. It can search places and businesses near a point, by rubric or by query, fetch a place card by ID, and convert addresses to coordinates and back. Routes are built for car, walking, bicycle, taxi, scooter and separately for public transport. For reviews it always returns rating and count, and tries to fetch texts through an undocumented endpoint. Coverage: Russia, CIS and other 2GIS regions.
Who it is for. Developers, analysts and marketers who need geodata and businesses in Russian and CIS cities.
Good fit when
- You need businesses of a category near an address
- You need to geocode addresses or find the address at coordinates
- You want to compare car and public transport travel times
Not a fit when
- You need review texts as a reliable source: fetching them is unofficial
- You need maps outside 2GIS coverage
Example request
Find pharmacies within a kilometer of Lenin Square in Novosibirsk and give walking directions to the nearestMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
TWOGIS_API_KEYrequired, secret- 2GIS API key from dev.2gis.com
TWOGIS_TIMEOUT_MS- Request timeout, default 10000
TWOGIS_LOCALE- Routing locale, default ru
Limitations
Requires a 2GIS API key. A demo key lasts about a month with roughly a thousand requests per service and smaller page limits for place search. Routing and public transport work only if your subscription includes them, otherwise the API returns 403. A key bound to a mobile SDK App ID will not work. Coordinates use lon,lat order.
How to disable. Remove the 2gis block from your MCP client config or run claude mcp remove 2gis.
FAQ
Why does search return nothing?
Most often coordinates were passed as lat,lon. The server expects longitude first.
Where do I get a rubric ID?
From the rubrics field in search_places results or the 2gis://rubrics resource.
How is 2GIS MCP different from other 2GIS servers?
The server gives the agent nine 2GIS tools, all read-only. The agent searches places and organizations near a point, by category or by query, gets a place card by ID, turns an address into coordinates, builds routes and shows ratings.
Why does search find nothing and where do I get a category ID?
Check the point, radius and query spelling: search runs around coordinates. A category ID comes from the rubrics field of search_places results or from the 2gis://rubrics resource. Install with the npx config in the install block, it works in Claude Desktop and Claude Code.
Discussion
No questions or reviews yet.
Related
All 2GIS tools2GIS 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
A community MCP server on top of the 2GIS search API: places, geocoder, suggestions, categories and regions, your own 2GIS key and Docker Compose
MapGL MCP Server (prototype)
MapGL MCP Server
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
A self-hosted MCP server on Cloudflare Workers for local SEO: organization search and cards in 2GIS, Yandex Geocoder and Google Places
A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data
A local SEO audit skill for the CIS market: business cards in Google Business Profile, Yandex Business, Yandex Maps, 2GIS and their consistency
README in short
The README lists nine tools and explains how to get a 2GIS key and which services it covers depending on the subscription. It covers demo key limits, coordinate order, pagination and the typical call chain from search to place card. It states that review texts come from an unofficial endpoint. A troubleshooting table maps common errors to causes. MIT license.