SkillFoxx

Type a name, a task or a service

2GIS MCP

@theyahia/2gis-mcp

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

MCP serverMedium riskRussian stack

theyahia/2gis-mcpAuthor: theYahia

Install

{
  "mcpServers": {
    "2gis": {
      "command": "npx",
      "args": ["-y", "@theyahia/2gis-mcp"],
      "env": { "TWOGIS_API_KEY": "your-key" }
    }
  }
}

Works for Claude Desktop and Claude Code. TWOGIS_TIMEOUT_MS and TWOGIS_LOCALE are optional.

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 nearest

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.

MCP

Transport
stdio
Authentication
API key
Environment variables
TWOGIS_API_KEY
required, secret		2GIS API key from dev.2gis.com
TWOGIS_TIMEOUT_MS
Request timeout, default 10000
TWOGIS_LOCALE
Routing locale, default ru

Security check

  • Calls the external 2GIS API and spends key quota
  • Some data comes from an undocumented endpoint

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.

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.

Editors’ pick

166 skills for scientific work: bioinformatics, cheminformatics, clinical data, geospatial analysis and 100+ databases

SkillMedium risk44.9K
Editors’ pick

Google's open-source MCP server for databases: ready tools for Postgres, MySQL, BigQuery, Spanner and more, plus custom tools in tools.yaml

MCP serverHigh risk16.4K
Editors’ pick

Official Hugging Face skills: Hub operations via the hf CLI, datasets, model training, Spaces, evals and deployment

SkillHigh risk11K
Editors’ pick

A token-lean MCP server for PostgreSQL, MySQL, MariaDB, SQL Server and SQLite with a read-only mode

MCP serverHigh risk3.5K