What can you do with this server?

Pumperly-MCP exposes a Pumperly fuel station instance as an MCP server, enabling LLMs to query real-time fuel prices, discover stations, plan routes, and geocode locations. * Find Nearest Stations (find_nearest_stations): Search for fuel stations closest to a given coordinate, filtered by fuel type (e.g., B7, E5, EV), with configurable radius and result limit. * Get Stations in Area (get_stations_in_area): Retrieve all fuel stations within a specified bounding box for a given fuel type. * Calculate Route (calculate_route): Compute a driving route between an origin and destination, with optional waypoints. * Find Route Stations (find_route_stations): Discover fuel stations within a corridor along a route (provided as a GeoJSON LineString), filtered by fuel type. * Geocode (geocode): Convert a place name, address, or POI query into geographic coordinates, with optional lat/lon biasing for more relevant results. * Read Resources (read-only): Access configuration (pumperly://config), statistics (pumperly://stats), and exchange rates (pumperly://exchange-rates). Transport options include HTTP (JSON-RPC over /mcp) or stdio (via npm).

de en es ja ko ru zh

pumperly-mcp

by GeiserX

Overview Schema Related Servers Score Discussions

Remote

What you get

Type	What for	MCP URI / Tool id
Resources	Browse configuration, statistics, and exchange rates read-only	`pumperly://configpumperly://statspumperly://exchange-rates`
Tools	Find stations, calculate routes, and geocode locations	`find_nearest_stationsget_stations_in_areacalculate_routefind_route_stationsgeocode`

Everything is exposed over a single JSON-RPC endpoint (/mcp). LLMs / Agents can: initialize -> readResource -> listTools -> callTool ... and so on.

Related MCP server: Foundry MCP Server

Quick-start (Docker Compose)

services:
  pumperly-mcp:
    image: drumsergio/pumperly-mcp:latest
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      - PUMPERLY_URL=https://pumperly.com

Security note: The HTTP transport listens on 127.0.0.1:8080 by default. If you need to expose it on a network, place it behind a reverse proxy with authentication.

Install via npm (stdio transport)

npx pumperly-mcp

Or install globally:

npm install -g pumperly-mcp
pumperly-mcp

This downloads the pre-built Go binary from GitHub Releases for your platform and runs it with stdio transport. Requires at least one published release.

Local build

git clone https://github.com/GeiserX/pumperly-mcp
cd pumperly-mcp

# (optional) create .env from the sample
cp .env.example .env && $EDITOR .env

go run ./cmd/server

Configuration

Variable	Default	Description
`PUMPERLY_URL`	`https://pumperly.com`	Pumperly instance URL (without trailing /)
`LISTEN_ADDR`	`127.0.0.1:8080`	HTTP listen address (Docker sets `0.0.0.0:8080`)
`TRANSPORT`	(empty = HTTP)	Set to `stdio` for stdio transport

Put them in a .env file (from .env.example) or set them in the environment.

Testing

Tested with Inspector and it is currently fully working. Before making a PR, make sure this MCP server behaves well via this medium.

Example configuration for client LLMs

{
  "schema_version": "v1",
  "name_for_human": "Pumperly-MCP",
  "name_for_model": "pumperly_mcp",
  "description_for_human": "Query real-time fuel prices, find stations, plan routes, and geocode locations via Pumperly.",
  "description_for_model": "Interact with a Pumperly instance that aggregates fuel station data. First call initialize, then reuse the returned session id in header \"Mcp-Session-Id\" for every other call. Use readResource to fetch URIs that begin with pumperly://. Use listTools to discover available actions and callTool to execute them.",
  "auth": { "type": "none" },
  "api": {
    "type": "jsonrpc-mcp",
    "url":  "http://localhost:8080/mcp",
    "init_method": "initialize",
    "session_header": "Mcp-Session-Id"
  },
  "logo_url": "https://pumperly.com/logo.png",
  "contact_email": "acsdesk@protonmail.com",
  "legal_info_url": "https://github.com/GeiserX/pumperly-mcp/blob/main/LICENSE"
}

Credits

Pumperly -- real-time fuel price aggregation

MCP-GO -- modern MCP implementation

GoReleaser -- painless multi-arch releases

Maintainers

@GeiserX.

Contributing

Feel free to dive in! Open an issue or submit PRs.

Pumperly-MCP follows the Contributor Covenant Code of Conduct.

Other MCP Servers by GeiserX

cashpilot-mcp — Passive income monitoring
duplicacy-mcp — Backup health monitoring
genieacs-mcp — TR-069 device management
lynxprompt-mcp — AI configuration blueprints
telegram-archive-mcp — Telegram message archive

Project	Description
Pumperly	Open-source fuel and EV route planner with real-time prices
Pumperly-android	Official Android app for Pumperly fuel and EV route planner
pumperly-ha	Home Assistant custom integration for Pumperly fuel and EV charging prices
n8n-nodes-pumperly	n8n community node for Pumperly fuel and EV charging data

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

0dRelease cycle

3Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

mcp-llm
Code Execution Autonomous Agents
sammcj
A
license
B
quality
C
maintenance
An MCP server that provides LLMs access to other LLMs
Last updated 2025-03-15
4
101
79
MIT
Foundry MCP Server
Blockchain Code Execution
PraneshASP
A
license
-
quality
F
maintenance
A lightweight, fast MCP server that provides onchain capabilities for the LLMs and Agents.
Last updated 2026-01-17
60
250
MIT
cashpilot-mcp
Monitoring Finance Agent Orchestration
GeiserX
A
license
A
quality
A
maintenance
MCP server that exposes any CashPilot instance to LLMs, enabling monitoring of passive income earnings, managing bandwidth-sharing services, and controlling fleet workers
Last updated 2026-08-01
10
49
3
GPL 3.0
auto-mcp-server
Developer Tools
alanbuxton
A
license
-
quality
B
maintenance
Enables LLMs to interact with any REST API that has an OpenAPI specification by providing a lightweight MCP server that translates between natural language and API calls.
Last updated 2026-07-02
MIT

View all related MCP servers

Related MCP Connectors

TokenOracle
Hosted MCP server for LLM cost estimation, model comparison, and budget-aware routing.
mcp
MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.
mcp-server
MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/GeiserX/pumperly-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server