OPET Fuel Prices MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
OPET Fuel Prices MCP Server
A Model Context Protocol (MCP) server that provides access to OPET fuel prices data through Claude AI.
Demo

Related MCP server: gasolineras-mcp
Features
Get all available provinces
Fetch fuel prices for specific provinces
Get last update timestamp
Error handling with detailed messages
Prerequisites
Before using this MCP server, you need to set up the OPET API server first.
1. Install OPET Package
Install the OPET package from https://github.com/sinanerdinc/opet:
pip install opet2. Start OPET API Server
Start the API server using one of the following methods:
Option A: Using CLI
opet-cli --apiOption B: Using Docker
docker run -p 8000:8000 sinanerdinc/opet apiOption C: Using Docker with custom port
docker run -p 5050:8000 sinanerdinc/opet apiThe API server will be available at http://localhost:8000 (or your custom port).
Installation
Prerequisites
Python 3.12 or higher
uv package manager (recommended) or pip
OPET package installed and API server running
Setup
Clone the repository:
git clone <repository-url>
cd opet-mcpUsing uv
# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh
# Create virtual environment and install dependencies
uv venv -p 3.12
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv syncConfiguration
Set the OPET API URL using environment variables. The URL should point to your running OPET API server:
# If using default port (8000)
export OPET_API_URL=http://localhost:8000
# If using custom port (e.g., 5050)
export OPET_API_URL=http://localhost:5050Usage
Running the Server
Start the MCP server:
# With uv
uv run fastmcp run server.py
# With pip
fastmcp run server.pyExample Configuration
Option 1: Install the server to Claude with a custom name and API URL:
{
"mcpServers": {
"Opet Server": {
"command": "uv",
"args": [
"run",
"--with",
"fastmcp",
"fastmcp",
"run",
"/your_absolute_path/opet-mcp/server.py"
],
"env": {
"OPET_API_URL": "http://localhost:8000"
}
}
}
}Option 2: Installation Command
fastmcp install server.py --name "OPET Fuel Prices" \
--env-var OPET_API_URL=http://localhost:8000Available Tools
get_all_provinces()
Retrieves a list of all provinces where fuel prices are available.
get_fuel_prices_by_province(province_id)
Fetches current fuel prices for a specific province using its ID.
Parameters:
province_id(str): The unique identifier of the province
get_last_update_time()
Gets the timestamp of when the fuel prices were last updated in the system.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Live official fuel station prices for France, Spain, Italy and Western Australia in one schema.
Turkey data API for AI agents: 40 tools + search/call for 230+ endpoints. Addresses (provinces, districts, postal codes, boundaries), validation (IBAN, tax ID/VKN, TCKN, phone, barcode), tax and salary calculators, Official Gazette, exchange rates, gold, crypto, economic indicators, prayer times, holidays and business days, weather, air quality, earthquakes, dam levels, fuel prices, EV charging, power outages, tolls, pharmacies on duty, football standings. Turkish JSON, free plan.
MCP server for China domestic fuel prices (92/95/98 gasoline, diesel) across 31 provinces with
Turkish data APIs as MCP tools: pharmacies, fuel, FX, gold, crypto, weather, prayer times, news.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides access to Korea Petroleum Corporation's Opinet fuel price API for South Korea. Enables querying of current national and regional fuel averages, recent price trends, lowest-price stations, and nearby gas station details through natural language.MIT
- AlicenseAqualityBmaintenanceProvides real-time fuel prices at gas stations in Spain using the government's public API. Enables users to find the cheapest fuel in a municipality or list stations sorted by price.2MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to query reference pump prices for 92/95/98 gasoline and 0# diesel across all 31 Chinese provincial-level regions, along with the next expected price-adjustment window, through a hosted Streamable HTTP endpoint or a self-hosted FastMCP server.MIT
- AlicenseNot gradedqualityBmaintenanceEnables querying current and historical retail petrol, diesel, and LPG prices across European countries, comparing prices by week, and checking data coverage.141 npmMIT