io.github.GeiserX/pumperly-mcp MCP Server

The io.github.GeiserX/pumperly-mcp server is a Model Context Protocol (MCP) server for Pumperly. It supports querying fuel prices, finding stations, and planning routes. Its published topics indicate integrations and data formats related to geocoding, GeoJSON, and routing, intended to run as a self-hosted component.

🛠️ Key Features

Query fuel prices
Find stations
Plan routes

🚀 Use Cases

Locate gas stations
Retrieve fuel price information
Generate route plans for travel

⚡ Developer Benefits

Built as an MCP server (model-context-protocol)
Includes implementation and ecosystem indicators: Go, golang, and json-rpc
Supports self-hosted deployment
Uses/mentions geocoding and GeoJSON
Includes Docker and stdio as integration signals
Aligns with OpenStreetMap-related data usage (openstreetmap)

⚠️ Limitations

Provided description and excerpt only confirm high-level capabilities; no tool list or specific endpoints are included here.

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 /mcp endpoint.

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):

json

{
  "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.

Install

Configuration

Environment variables

PUMPERLY_URL

Pumperly API base URL (e.g. https://pumperly.com)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "pumperly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pumperly-mcp@0.1.1"
      ],
      "env": {
        "PUMPERLY_URL": "<YOUR_PUMPERLY_URL>"
      }
    }
  }
}

io.github.GeiserX/pumperly-mcp