China Fuel Price MCP

Name: Fuel
Author: pianam

China domestic refined-fuel (gasoline & diesel) prices for AI agents: query pump prices for 92# / 95# / 98# gasoline and 0# diesel in any of China's 31 provincial-level regions, or get the full national list, plus the next expected price-adjustment window.

Try it in 30 seconds: a free public MCP endpoint is already running — just paste the URL into your MCP client (no install, no API key).
Or self-host: a small FastMCP server. A bundled static price table (clearly dated) guarantees answers even when no live source is reachable.

⚡ Use the hosted endpoint (no setup)

https://mcp.pianam.cn/fuel-mcp/mcp

Transport: Streamable HTTP (MCP 2025-03-26 compatible). No authentication required.

🔌 Client configuration

Add this to your MCP client's mcpServers configuration (Claude Desktop, Cursor, Cline, Cherry Studio, etc.):

json

{
  "mcpServers": {
    "fuel": {
      "type": "http",
      "url": "https://mcp.pianam.cn/fuel-mcp/mcp"
    }
  }
}

Clients that do not accept "type": "http" accept the same entry with just "url".

🧰 Tools

---|---|---| | query_oil_price(province="") | province: optional region name — full (山东省), short (山东), or one-character abbreviation (鲁/京). Omit to get all regions. | Single region: 92#/95#/98# gasoline and 0# diesel prices (CNY/liter), data date, data source, next adjustment window. No argument: prices for all 31 provincial-level regions, with data date and next adjustment window. |

Examples

"山东今天 92 号汽油多少钱？" → Shandong fuel prices.
"广东油价" → Guangdong prices.
"全国油价列表" → all regions.

📡 Data

The server attempts live sources in order (CNPC official site, NDRC announcements, WallStreetCN commodities); when none yields structured data it falls back to a bundled static price table whose date is always returned in the response (data_date / data_source fields).
Region names accept full names, short names and traditional one-character abbreviations (京/沪/鲁/粤…).
Prices are reference benchmark prices in CNY per liter; actual pump prices may vary by station and promotions. No API key required.

Adjust the bundled table (STATIC_OIL_PRICES / STATIC_DATA_DATE in fuel_server.py) to refresh figures between releases.

🐢 Self-hosting

bash

git clone https://github.com/boy-373/fuel-mcp.git
cd fuel-mcp
pip install -r requirements.txt
python server.py
# listens on 127.0.0.1:8000 by default; override with:
#   MCP_HOST=0.0.0.0 MCP_PORT=9000 python server.py
# behind a reverse proxy, allow your public hostname:
#   MCP_ALLOWED_HOSTS="your-domain.com,your-domain.com:*" python server.py

Then point your MCP client at http://127.0.0.1:8000/mcp.

With uv:

bash

uv venv && uv pip install -r requirements.txt
uv run python server.py

🗂️ Files

fuel_server.py — the MCP server: price table, province-name normalization, live-source attempts with static fallback, FastMCP tool definition.
server.py — standalone Streamable HTTP entry point (serves the MCP app at /mcp).
requirements.txt — Python dependencies.
LICENSE — MIT.