OPET Fuel Prices MCP Server

A Model Context Protocol (MCP) server that provides access to OPET fuel prices data through Claude AI.

Demo

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:

2. Start OPET API Server

Start the API server using one of the following methods:

Option A: Using CLI

Option B: Using Docker

Option C: Using Docker with custom port

The 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

1. Clone the repository:

2. Using uv

Configuration

Set the OPET API URL using environment variables. The URL should point to your running OPET API server:

Usage

Running the Server

Start the MCP server:

Example Configuration

Option 1: Install the server to Claude with a custom name and API URL:

Option 2: Installation Command

Available 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.