Pumperly
MCP server for Pumperly — query fuel prices, find stations, and plan routes
Runs on your machine from its package; the steps are below.
What it does
- Reads
- Writes
- High impact
At most: only reads or looks up information.
What it costs
FreeOdel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
npx -y pumperly-mcp
MCP client config
{
"mcpServers": {
"pumperly": {
"command": "npx",
"args": [
"-y",
"pumperly-mcp"
]
}
}
}Run
docker run -i --rm drumsergio/pumperly-mcp:v0.1.2
MCP client config
{
"mcpServers": {
"pumperly": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"drumsergio/pumperly-mcp:v0.1.2"
]
}
}
}
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
/mcpendpoint. - 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
