Pumperly Mcp

Name: Pumperly Mcp
Author: GeiserX

@GeiserX

Repository

About Pumperly Mcp

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "pumperly": {
      "command": "npx",
      "args": [
        "-y",
        "pumperly-mcp"
      ],
      "env": {
        "PUMPERLY_URL": "https://pumperly.com"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.