Japan JEPX Electricity Spot Price MCP avatar

Japan JEPX Electricity Spot Price MCP

Pricing

from $5.00 / 1,000 results

Go to Apify Store
Japan JEPX Electricity Spot Price MCP

Japan JEPX Electricity Spot Price MCP

MCP server: Japan wholesale electricity spot prices (JEPX). System + 9 areas, 30-min granularity (48 periods/day), JPY/kWh.

Pricing

from $5.00 / 1,000 results

Rating

0.0

(0)

Developer

atushi ino

atushi ino

Maintained by Community

Actor stats

0

Bookmarked

1

Total users

0

Monthly active users

a day ago

Last modified

Categories

Share

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)

ToolDescription
get_latest_spot_priceLatest spot price for an area (default tokyo)
get_spot_price_by_dayFull 48-period day curve + min/max/avg
get_spot_price_historyDaily-average history (min/max/avg over window)
get_cheapest_spotCheapest 30-min slots, or cheapest-area ranking
list_spot_areasArea catalogue + unit + latest date

REST endpoints (OpenAPI gateway)

EndpointDescription
GET /rest/latest?area=tokyoLatest spot price (numeric)
GET /rest/date?area=tokyo&date=YYYY-MM-DDFull-day curve
GET /rest/history?area=tokyo&days=14Daily-average history
GET /rest/cheapest?area=tokyo&limit=5Cheapest slots / areas
GET /rest/areasArea list + unit + periods/day
GET /openapi.jsonOpenAPI 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

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