# Pumperly

> Pumperly is an open-source MCP server for maps and travel. Find the cheapest fuel or EV charging near a place or along a drive in about 40 countries. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/geiserx/pumperly-mcp
- **MCP Registry name:** io.github.GeiserX/pumperly-mcp
- **Categories:** maps and travel
- **Listing updated:** 2026-11-14

## About

Pumperly is a station price service, mostly covering Europe, and this server gives an AI agent six read-only tools for it. The most direct one, cheapest_fuel_on_route, answers where to fill up between two places in a single call. Others find the nearest stations to a place name or coordinates by distance or price, list stations in a bounding box cheapest first, find stations along a route you already have, calculate driving distance and time with up to five stops, and geocode a place name.

Station lists are sorted, cut to a limit and summarised with minimum, median and maximum price, so a search takes about 1 KB of context. Four resources expose fuel types, configuration, stats and exchange rates.

It uses the public instance at pumperly.com with no API key, or your own Pumperly instance through the PUMPERLY_URL setting. Every tool only reads, so there is no read-only switch. It runs over stdio from an npm package that checks the binary's SHA-256, or over HTTP with a bearer token, and is licensed GPL-3.0-or-later.

## Features

- **Cheapest on route:** Finds where to fill up between two places.
- **Nearest stations:** Search by place name or coordinates.
- **Area search:** Stations in a bounding box, cheapest first.
- **Route calculation:** Driving distance and time with up to 5 stops.
- **Compact answers:** Sorted lists with min, median and max price.
- **Own instance support:** Point at a self-hosted Pumperly instance.

## Good for

- Plan a fuel stop on a road trip
- Find cheap EV charging near a city
- Compare fuel prices in an area
- Estimate driving distance and time between stops

## Install

### Claude Code (Terminal)

```sh
claude mcp add pumperly-mcp -- npx -y pumperly-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pumperly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pumperly-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pumperly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pumperly-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pumperly-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pumperly-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pumperly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pumperly-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pumperly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pumperly-mcp"
      ]
    }
  }
}
```

## Tools

- `cheapest_fuel_on_route`: Finds the cheapest places to fill up between two places.
- `find_nearest_stations`: Finds stations near a place or coordinates.
- `get_stations_in_area`: Lists stations inside a bounding box, cheapest first.
- `calculate_route`: Calculates driving distance and time with stops.
- `find_route_stations`: Finds stations along a given route geometry.
- `geocode`: Converts a place name to coordinates.

## FAQ

### Does it need an API key?

No. It uses the public Pumperly instance by default.

### Which countries are covered?

About 40 countries, mostly in Europe.

### Can it change anything?

No. All six tools are read-only.

### Can I use my own server?

Yes, set PUMPERLY_URL to your own Pumperly instance.

### Is Pumperly free?

Yes. Pumperly is open source, so you can use and self-host it for free.

### How do I add Pumperly to Claude Code?

Run this command in your terminal: claude mcp add pumperly-mcp -- npx -y pumperly-mcp

### What are the best alternatives to Pumperly?

The closest alternatives to Pumperly are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/pumperly
