SkillFoxx

2GIS Search MCP Server

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

  • 1 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Runs a Python server that searches places and geocodes addresses with a 2GIS key
  • Only reads Search API data
All reasons and checks
Russian stack

kskadart/2gis-mcp-serverAuthor:kskadart

Install

Services

Manual install

uv sync && python3 -m src.main --transport stdio

Local stdio launch after creating a .env with the key.

Access and checks

How we review

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

  • Runs a Python server that searches places and geocodes addresses with a 2GIS key
  • Only reads Search API data

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

What it does

The server wraps the 2GIS Search API into MCP tools: place search by name and location, a geocoder to convert addresses to coordinates, address autocomplete suggestions, business category search, region search by name, and map markers for search results. It runs locally over stdio via python3 -m src.main, or in Docker Compose with streamable-http transport on port 8101. The 2GIS key and API address are set in a .env file.

Who it is for. For developers and analysts who need simple access to the 2GIS search API from an agent without an official server.

Good fit when

  • You need 2GIS place and business search by name near a point
  • You need a geocoder to convert addresses to coordinates and back in your own pipeline
  • You need to run the server in Docker Compose with HTTP transport, not just stdio

Not a fit when

  • You need routes or isochrones: this server does not compute them, only search and geocoding
  • You need the official 2GIS server: this is an independent community project

Example request

Find coffee shops within 500 meters of my office coordinates using 2GIS

MCP

Transport
stdio, sse, http
Authentication
API key

Environment variables

DGIS_API_KEY required, secret
A 2GIS API Console key for the Search API.
DGIS_SEARCH_API_URL required
The base API address, defaulting to https://catalog.api.2gis.com.

Limitations

It needs your own key from the 2GIS API Console, and 2GIS may ask about your use case and limit the region or volume. The project is small, with no ready npm or PyPI package; it is installed by cloning the repo and running uv sync. There are no routes or isochrones, only the Search API.

How to disable. Remove the server from your MCP client config and stop the container with docker-compose down if you used Docker.

FAQ

Where do I get a 2GIS key?

At dev.2gis.com you register and create a project with a Search API key; 2GIS may ask you to describe your use case.

Can this server build routes?

No, it only covers Search API search, geocoding, suggestions, categories and regions.

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

2GIS MCP

2GIS MCP (mapgl-mcp-server)

Official

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

MCP serverExtended access6
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 English README describes the server as a simple wrapper over the 2GIS Search API, gives instructions for getting a key at dev.2gis.com, install steps via uv sync, launch parameters for transport, host, port and debug, and a Docker Compose option with streamable-http on port 8101, plus verification via MCP Inspector.

README badge

Report a problem