2ГИС MCP: Documentation

Connection

npx -y @theyahia/2gis-mcp (stdio) or HTTP_PORT=3000 npx @theyahia/2gis-mcp --http. Auth: TWOGIS_API_KEY — a key from the dev.2gis.com developer dashboard (needs access to the Catalog, Geocoder, Routing and Reviews sections). The key is sent as a key= query parameter on every request — never logged or included in error text.

Capabilities

8 tools: places (search_places — query search with an optional center point and radius, get_place — full detail for a 2GIS place ID: address, schedule, phones, photos, reviews, search_by_rubric — search by category near a point), geocoding (geocode, reverse_geocode), directions and suggestions (get_directions — driving/walking/transit, suggest — type-ahead), reviews (get_reviews).

Agent flow

"Find coffee shops within 1km of a point in central Moscow", "get driving directions from the Kremlin to Sheremetyevo airport", "geocode 'Moscow, Tverskaya 13' and show reviews for the first place found".

Note

A community project (theYahia), not an official 2GIS product. Unlike Apify-style scrapers that parse 2GIS cards outside the API, this server strictly calls official endpoints — more stable, but it needs a dev.2gis.com key and lives within its rate limits and pricing tiers.