How do I install Pumperly?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Pumperly need an API key?

The publisher lists these environment variables: PUMPERLY_URL.

What transport does Pumperly use?

Pumperly runs locally over stdio.

Pumperly

Q: When was Pumperly last checked?

Last checked 2026-10-16. MCP server for Pumperly — query fuel prices, find stations, and plan routes

by io.github.GeiserX

MCP server for Pumperly — query fuel prices, find stations, and plan routes

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Local command

npx -y [email protected]

Credentials from the publisher

PUMPERLY_URL — Pumperly API base URL (e.g. https://pumperly.com)

Provider

Claude Code

PUMPERLY_URL=<value> claude mcp add io.github.geiserx-pumperly-mcp -- npx -y [email protected]

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.github.geiserx-pumperly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "PUMPERLY_URL": "<value>"
      }
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

Related skills

View all

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