Pumperly Mcp

What is Pumperly Mcp?

Pumperly Mcp is a bridge that exposes any Pumperly instance as an MCP server, enabling large language models to query real‑time fuel prices, find stations, plan routes, and geocode locations. It is intended for developers and LLM agents who need to integrate fuel‑price data into their workflows.

How to use Pumperly Mcp?

Install via Docker Compose (drumsergio/pumperly-mcp:latest), via npm (npx pumperly-mcp or global install), or by building from source with Go. Configure the Pumperly instance URL with the PUMPERLY_URL environment variable, choose transport (HTTP on port 8080 by default or stdio), and then use MCP tools to interact.

Key features of Pumperly Mcp

• Provides read‑only resources (pumperly://config, pumperly://stats, pumperly://exchange‑rates)
• Offers tools: find_nearest_stations, get_stations_in_area, calculate_route, find_route_stations, geocode
• Exposes a single JSON‑RPC endpoint at /mcp
• Supports both HTTP and stdio transports
• Fully tested with the MCP Inspector

Use cases of Pumperly Mcp

• Find the cheapest fuel stations near a given location
• Calculate a route and list stations along it
• Geocode addresses or place names for station searches
• Integrate real‑time fuel prices into AI assistants or chatbots

FAQ from Pumperly Mcp

What is Pumperly Mcp?

It is a small server that acts as a bridge between any Pumperly instance and the Model Context Protocol, allowing LLMs to query fuel‑price data through standard MCP resources and tools.

How do I install and run Pumperly Mcp?

You can run it via Docker Compose with the image drumsergio/pumperly-mcp:latest, install it globally with npm (npm install -g pumperly-mcp), or build it locally from the GitHub repository.

What transport protocols does it support?

It supports HTTP (default, listening on 127.0.0.1:8080) and stdio (set the TRANSPORT environment variable to stdio).

Does Pumperly Mcp require authentication?

No, authentication is set to none. The HTTP transport listens on localhost by default; if exposed to a network, it should be placed behind a reverse proxy with authentication.

What can I do with Pumperly Mcp?

You can read configuration, statistics, and exchange rates via its resources, and call tools to find nearby stations, get stations in an area, calculate routes, find stations along a route, and geocode locations.