Summary
Connects Claude to any Pumperly instance for real-time fuel price lookups and route planning. Exposes five tools: find nearest stations by coordinates, search stations within a bounding box, calculate optimal routes, find stations along a route, and geocode addresses. Also surfaces three read-only resources for instance configuration, statistics, and exchange rates. Built in Go with both stdio and HTTP transports. Useful when you need LLMs to answer questions like "find the cheapest diesel within 5km" or "plan a route from Madrid to Barcelona with fuel stops under €1.50/liter." Wraps the Pumperly API, which aggregates data from government sources and crowdsourced reports across multiple countries.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
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
License
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Configuration
PUMPERLY_URLPumperly API base URL (e.g. https://pumperly.com)