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.

MCP Registry

This server is registered on the official MCP Registry. Find it via search: japan-jepx-mcp

---

Data & Store

• Apify Store: https://apify.com/fruitful_quintessence
• Gumroad datasets: https://atushi5.gumroad.com/l/kutuxe