About
Japan JEPX electricity spot prices (system + 9 areas)
Security Report
The server is a read-only public-data MCP with no exfiltration, shell execution, or hardcoded secrets, and its inputs are validated. The main concern is that the bundled 'seed cache' is randomly generated by scripts/seed_jepx.py, yet it is served with attribution to JEPX settlement prices whenever the live fetch fails, so users may act on fabricated prices. Authentication for the MCP and REST routes is delegated entirely to the Apify platform. Supply chain analysis found 6 known vulnerabilities in dependencies (1 critical, 4 high severity).
8 files analyzed · 11 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-atushi1841-japan-jepx-mcp": {
"args": [
"japan-jepx-mcp"
],
"command": "uvx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Worldmonitor
Freeby Koala73 · Developer Tools
Live markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.