io.github.atushi1841/japan-jepx-mcp

Japan JEPX Electricity Spot Price MCP

MCP server exposing Japanese wholesale electricity spot prices from JEPX (Japan Electric Power Exchange) — the system (nationwide) price plus 9 regional area prices at 30-minute granularity (48 periods/day), in JPY/kWh.

Data source: JEPX spot settlement prices (Government Standard Terms of Use), with OCCTO area-price forecast for regional deltas. A bundled seed cache (data/jepx_spot.json, ~400 days × 48 periods = 19,200 records) guarantees offline/fallback answers; a live fetch to JEPX.org is attempted and gracefully falls back to the seed when the site is IP-restricted.

Output sample

{
  "date": "2026-09-17",
  "area": "tokyo",
  "area_label": "東京 (Tokyo)",
  "price": 15.24,
  "unit": "JPY/kWh",
  "period": 48
}

Tools (MCP, 5)

Tool	Description
get_latest_spot_price	Latest spot price for an area (default tokyo)
get_spot_price_by_day	Full 48-period day curve + min/max/avg
get_spot_price_history	Daily-average history (min/max/avg over window)
get_cheapest_spot	Cheapest 30-min slots, or cheapest-area ranking
list_spot_areas	Area catalogue + unit + latest date

REST endpoints (OpenAPI gateway)

Endpoint	Description
GET /rest/latest?area=tokyo	Latest spot price (numeric)
GET /rest/date?area=tokyo&date=YYYY-MM-DD	Full-day curve
GET /rest/history?area=tokyo&days=14	Daily-average history
GET /rest/cheapest?area=tokyo&limit=5	Cheapest slots / areas
GET /rest/areas	Area list + unit + periods/day
GET /openapi.json	OpenAPI document

Areas (order of regional prices): system (nationwide), hokkaido, tohoku, tokyo, chubu, hokuriku, kinki (aka kansai), chugoku, shikoku, kyushu. Romaji and kanji (e.g. tokyo / 東京) both accepted.

Use cases

• EV charging scheduling / home-battery arbitrage
• Manufacturing load-shifting to cheap hours
• Electricity market monitoring and forecasting analysis
• Energy cost benchmarking for Japan

Local run

uv run --directory . src/stdio_main.py   # stdio MCP (Claude Desktop / Cursor)
# or REST-only smoke against the seed:
JEPX_DATA_DIR=/tmp/jepx-smoke python3 smoke_rest.py

Deployment

Apify Actor japan-jepx-mcp (Standby mode, webServerMcpPath=/mcp, Dockerfile CMD ["python", "-m", "src.main"]): https://fruitful-quintessence--japan-jepx-mcp.apify.actor/mcp

Apify Store

This MCP server is also available as a managed Apify Actor:

• Apify Store: japan-jepx-mcp — Japanese wholesale electricity spot prices from JEPX (PPE课金). Run from the Apify Store (Run button), then point your MCP client at the endpoint.

Data & attribution

• Source: JEPX (Japan Electric Power Exchange) spot market settlement prices — jepx.org · OCCTO demand/supply area price forecast — occto.or.jp
• Data licensing: Government Standard Terms of Use (出典明示で商用利用可)
• Unit: JPY/kWh (円/kWh); 48 × 30-min periods per trading day

Install via Smithery

Connect this MCP server to your AI client (Claude Desktop, Cursor, VS Code) in one command:

npx @smithery/cli install atushi1841/japan-jepx-mcp --client claude

Replace claude with cursor, vscode, or cline for other clients.

Alternatively, install directly from the Smithery registry.

Note: Smithery server listing is pending verification. Once verified, this server will appear in search results with useCount tracking.