English Français العربية

io.github.atushi1841/japan-jepx-mcp

Official registry Other

Japan JEPX Electricity Apify:apify.com/fruitful_quintessence | Gumroad:atushi5.gumroad.com/l/kutuxe

Source code Documentation

What can you do with io.github.atushi1841/japan-jepx-mcp?

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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

MCPB package https://github.com/atushi1841/japan-jepx-mcp/releases/download/v0.1.1/server.mcpb

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Japan JEPX Electricity Spot Price MCP
  2. Output sample
  3. Tools (MCP, 5)
  4. REST endpoints (OpenAPI gateway)
  5. Use cases
  6. Local run
  7. Deployment
  8. Apify Store
  9. Install via Smithery
  10. MCP Registry
  11. Data & Store

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)

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

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

Frequently asked questions

What is io.github.atushi1841/japan-jepx-mcp?

Japan JEPX Electricity Apify:apify.com/fruitful_quintessence | Gumroad:atushi5.gumroad.com/l/kutuxe

How do I install io.github.atushi1841/japan-jepx-mcp?

Follow the installation steps in its documentation, shown on this page and in its repository.

Does io.github.atushi1841/japan-jepx-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.atushi1841/japan-jepx-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.atushi1841/japan-jepx-mcp?

It is published by atushi1841. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.