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

Tool	Description	Source
japan_earthquakes(min_magnitude, min_intensity, limit)	Recent earthquakes: epicenter, magnitude, max intensity, depth	JMA (気象庁)
japan_weather_warnings(area)	Active weather warnings/advisories, filterable by prefecture	JMA
japan_weather_overview(prefecture)	Narrative weather summary (10 major prefectures)	JMA
japan_weekly_forecast(prefecture)	7-day forecast: high/low temps, precipitation probability, reliability	JMA
japan_typhoons()	Active typhoon tracking	JMA
japan_edinet_filings(date)	Statutory corporate disclosures (annual reports, timely disclosure)	EDINET
japan_postal_lookup(zipcode)	Postal code → address (kanji and kana)	zipcloud
japan_watch_summary(min_magnitude)	One-call cross-source summary of the above	JMA

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

Channel	Command / URL
MCP bundle	v0.2.1 release (.mcpb)
Official MCP registry	io.github.atushi1841/japan-intel-mcp
Apify (Standby MCP)	fruitful_quintessence/japan-intel-mcp (in preparation)
PyPI	pip install japan-intel-mcp (publication in progress)

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