English Français العربية

Pumperly

Official registry Productivity

Cheapest fuel and EV charging near a place or along a drive, in about 40 countries

Source code Website Documentation

What can you do with Pumperly?

  • Five tools: find_nearest_stations, get_stations_in_area, calculate_route, find_route_stations, geocode.
  • Three read-only resources: pumperly://config, pumperly://stats, pumperly://exchange-rates.
  • Two transports: stdio, and HTTP on a single /mcp endpoint.
  • An npm package that downloads the release binary for your platform and runs it over stdio.
  • A Docker image for amd64 and arm64.
  • Works with the public instance at pumperly.com or your own: set PUMPERLY_URL.
  • No API key: it reads the Pumperly API anonymously.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package pumperly-mcp
Claude Code 
claude mcp add pumperly -e 'PUMPERLY_URL=https://pumperly.com' -- npx -y pumperly-mcp@0.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pumperly": {
            "command": "npx",
            "args": [
                "-y",
                "pumperly-mcp@0.2.0"
            ],
            "env": {
                "PUMPERLY_URL": "https://pumperly.com"
            }
        }
    }
}

Environment variables

  • PUMPERLY_URL Pumperly instance URL (default https://pumperly.com); set it to use your own instance
OCI package drumsergio/pumperly-mcp:v0.2.0
Claude Code 
claude mcp add pumperly -e 'PUMPERLY_URL=https://pumperly.com' -- docker run -i --rm drumsergio/pumperly-mcp:v0.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pumperly": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "drumsergio/pumperly-mcp:v0.2.0"
            ],
            "env": {
                "PUMPERLY_URL": "https://pumperly.com"
            }
        }
    }
}

Environment variables

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. pumperly-mcp
  2. Features
  3. Quick start
  4. Documentation
  5. License

pumperly-mcp

A small bridge that exposes any Pumperly instance as an MCP server, so an AI agent can query fuel prices, find stations, plan routes and geocode places.

Features

  • Five tools: find_nearest_stations, get_stations_in_area, calculate_route, find_route_stations, geocode.
  • Three read-only resources: pumperly://config, pumperly://stats, pumperly://exchange-rates.
  • Two transports: stdio, and HTTP on a single /mcp endpoint.
  • An npm package that downloads the release binary for your platform and runs it over stdio.
  • A Docker image for amd64 and arm64.
  • Works with the public instance at pumperly.com or your own: set PUMPERLY_URL.
  • No API key: it reads the Pumperly API anonymously.

Quick start

Add this to your MCP client's configuration (Claude Desktop, Claude Code, Cursor and others read the mcpServers format):

{
  "mcpServers": {
    "pumperly": {
      "command": "npx",
      "args": ["-y", "pumperly-mcp"],
      "env": { "PUMPERLY_URL": "https://pumperly.com" }
    }
  }
}

For the HTTP transport (/mcp on port 8080) run the Docker image; see Getting started.

Documentation

  • Getting started: npm, Docker Compose, building from source, connecting a client
  • Configuration: environment variables
  • Usage: tools, resources, the request flow, testing with the Inspector
  • Related projects: the Pumperly family, other MCP servers, registry listings

License

GPL-3.0-or-later

Frequently asked questions

What is Pumperly?

Cheapest fuel and EV charging near a place or along a drive, in about 40 countries

How do I install Pumperly?

It runs on your machine. In Claude Code: claude mcp add pumperly -e 'PUMPERLY_URL=https://pumperly.com' -- npx -y pumperly-mcp@0.2.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Pumperly need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Pumperly open source?

Yes. Its code is on GitHub under the GPL-3.0 license.

Who maintains Pumperly?

It is published by GeiserX. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.