Skip to content
MCP server

Pumperly

Find the cheapest fuel or EV charging near a place or along a drive in about 40 countries

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.3
Listing updated
2 days ago

About Pumperly

Pumperly is an open-source MCP server for maps and travel. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add pumperly-mcp -- npx -y pumperly-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pumperly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pumperly-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pumperly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pumperly-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • PUMPERLY_URLPumperly instance URL (default https://pumperly.com); set it to use your own instance
  • PUMPERLY_URLPumperly instance URL (default https://pumperly.com); set it to use your own instance

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

GPL-3.0-or-later; no API key needed

Pumperly 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 to Pumperly

  1. Tutu eSIM

    MCP server

    Live travel eSIM plans, prices and roaming costs for 190+ countries

    • 5 tools
    • Remote
    • Paid
    • Maps and travel
  2. Curated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang

    • 9 tools
    • Remote
    • Free
    • Maps and travel
  3. Fifty Asks

    MCP server

    Let an agent book a free AI-visibility check or a 15-minute call for a local business

    • 10 tools
    • Remote
    • Free
    • Maps and travel
  4. Gangway AIS

    MCP server

    Vessel positions, port calls and anchorage waiting times from licensed AIS data

    • 21 tools
    • Remote
    • Freemium
    • Freight and logistics
  5. Goyondo

    MCP server

    Agent-native trip planner where your AI builds the itinerary and Goyondo stores it

    • Remote
    • Freemium
    • Maps and travel