gdebenz-mcp

MCP server for finding gasoline and diesel at Russian gas stations. Combines two independent sources — gdebenz.ru and gdebenzi.ru — crowdsourced fuel availability maps with real-time driver check-ins.

Lets your AI assistant (Claude, Cursor, OpenClaw, etc.) answer questions like:

"Where near Khimki is there 95-octane gasoline?" "What's the nearest Lukoil station with diesel, and is there a queue?"

Works through the public APIs of both services. No API keys needed — just Python and two packages.

Two data sources

The search tools have a source parameter: "gdebenz", "gdebenzi", or "both" (default is both — maximum coverage).

Installation

1. Clone the repository

git clone https://github.com/ivanegorenkov/gdebenz-mcp.git
cd gdebenz-mcp

2. Install dependencies

pip install -r requirements.txt

Requires Python 3.10+.

3. Connect the server to your assistant

Claude Desktop — open/create claude_desktop_config.json:

{
  "mcpServers": {
    "gdebenz": {
      "command": "python3",
      "args": ["/АБСОЛЮТНЫЙ/ПУТЬ/gdebenz-mcp/server.py"]
    }
  }
}

Cursor — in the project's .cursor/mcp.json (or global ~/.cursor/mcp.json):

{
  "mcpServers": {
    "gdebenz": {
      "command": "python3",
      "args": ["/АБСОЛЮТНЫЙ/ПУТЬ/gdebenz-mcp/server.py"]
    }
  }
}

OpenClaw:

openclaw mcp add gdebenz --command python3 --arg /АБСОЛЮТНЫЙ/ПУТЬ/gdebenz-mcp/server.py

⚠️ Replace /ABSOLUTE/PATH/ with the actual path where the repository was cloned (you can find it by running pwd inside the folder).

Related MCP server: opinet-mcp

Instructions for the AI agent

If the user asks to "set up this MCP server" — do the following:

1. git clone https://github.com/ivanegorenkov/gdebenz-mcp.git

2. cd gdebenz-mcp && pip install -r requirements.txt

3. Determine the user's MCP host (Claude Desktop / Cursor / OpenClaw) and add the gdebenz entry to its config, as shown above (with the absolute path to server.py).

4. Restart the host/application.

5. Verify the server is visible (in OpenClaw: openclaw mcp probe gdebenz).

The server is stdio-based and requires no external keys.

What it can do (9 tools)

Example request to the assistant: find_fuel(location="Khimki", fuel="95", brand="Lukoil", source="both").

Semantics

• Fuel: 92, 95, 98, 100, diesel. For gdebenz — fuels_now (comma-separated string), for gdebenzi — fuels_yes / fuels_no / fuels_maybe (arrays with Russian names, e.g. ["АИ-95", "ДТ"]).

• Status: yes — available, queue — available/queue, low — low, no — unavailable, unknown — unknown, changing — updating, dtonly — diesel only.

• Freshness: for gdebenz — last_at, confirmations, confidence (0..1); for gdebenzi — last_mark (check-in time), confidence_pct, marks, reports. Both sources return age_minutes and freshness ("just now", "3 h ago").

• Queue/limits (gdebenzi): queue ("queue of 25–50 cars"), limits (limit in liters per fuel grade).

• Prices: gdebenz — prices_now[fuel].t (price report time); gdebenzi — prices (keys ai92/ai95/ai98/ai100/dt/gas) and regional_prices (regional averages).

API (where the data comes from)

gdebenz.ru

gdebenzi.ru

License

MIT