io.github.atushi1841/japan-intel-mcp

japan-intel-mcp

MCP server for Japanese public data — earthquakes, weather warnings, typhoons, weekly forecasts, corporate filings (EDINET), and postal-code lookup. Free, keyless, no API key required.

An MCP server that gives AI agents cross-source access to live Japanese public data with citations. Every response carries sources and data_gaps, so agents can tell what was retrieved and what was not.

Built for AI agents, LLM toolchains, and developers who need current Japan information without scraping or paying for a data vendor.

Why this exists

Most "global intelligence" MCP servers are built on Western data sources. Japanese public data is free and authoritative (Japan Meteorological Agency, EDINET, Japan Post) but scattered across HTML pages and undocumented endpoints. This server normalizes them behind 8 read-only tools.

• Free — no API key, no signup, no rate-limit tier
• Cited — every response includes sources
• Honest — failures are reported in data_gaps, never silently dropped

Tools

Response format

{
  "retrieved_at": "2026-10-12T01:30:00+00:00",
  "sources": ["https://www.jma.go.jp/bosai/quake/data/list.json"],
  "data_gaps": [],
  "data": []
}

Install

pip install -e .

Usage

japan-intel-mcp          # stdio mode (Claude Code / Cursor / Hermes / any MCP client)
python -m japan_intel_mcp.server

Claude Code

{
  "mcpServers": {
    "japan-intel-mcp": {
      "command": "japan-intel-mcp"
    }
  }
}

Hermes

mcp:
  servers:
    japan-intel:
      command: japan-intel-mcp

Examples

japan_earthquakes(min_magnitude=4.0, limit=5)
japan_weather_warnings(area="Tokyo")
japan_weekly_forecast(prefecture="Tokyo")
japan_postal_lookup(zipcode="1000001")
japan_watch_summary(min_magnitude=3.0)

Where to get it

Design contract

• Always cite — every response includes a sources list
• Never hide gaps — unavailable sources appear in data_gaps instead of being silently omitted
• Free only — no paid API keys anywhere

License

MIT

日本語

日本の公開情報を横断する読み取り専用の MCP サーバー。すべてのデータ源が無料・APIキー不要です。AIエージェントが「今の日本で何が起きているか」を、出典付きで取得できます。

• 出典を必ず返す: 各応答に sources リストが入ります
• 取れなかったものを隠さない: 取得に失敗したデータ源は data_gaps に明示します
• 無料のみ: 有料APIキーは一切不要です

ツール一覧は上部の表を参照してください（8ツール）。

MCP 公式レジストリ登録済み

本サーバーはMCP公式レジストリに登録済みです。

• Registry: MCP Registry

# レジストリでの確認
curl -s "https://registry.modelcontextprotocol.io/v0.1/servers?search=atushi1841" | grep -o "\"io.github.atushi1841/japan-intel-mcp\""

Data Source: Apify Store & Smithery Registry

This MCP server is available on:

• Apify Store: japan-intel-mcp — Japan public data (earthquakes, weather, EDINET, postal) MCP server
• Smithery Registry: Install via Smithery — MCP server for AI agents

Install via Smithery:

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

Data & Store

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