{
  "markdown": "# japan-data-mcp\n\n[![npm version](https://img.shields.io/npm/v/@mameta/japan-data-mcp)](https://www.npmjs.com/package/@mameta/japan-data-mcp)\n[![license](https://img.shields.io/npm/l/@mameta/japan-data-mcp)](https://www.apache.org/licenses/LICENSE-2.0)\n[![Japan Furigana API on x402-list](https://x402-list.com/badge/japan-furigana-api.svg)](https://x402-list.com/services/japan-furigana-api?utm_source=badge&utm_medium=referral&utm_campaign=embed)\n\n> npm: [`@mameta/japan-data-mcp`](https://www.npmjs.com/package/@mameta/japan-data-mcp) · MCP Registry: `io.github.Mameta29/japan-data-mcp` · transport: **stdio**\n\nAn **MCP server** that gives AI agents (Claude Desktop, Cursor, Cline, …) one-call\naccess to the [agentic-jp.com](https://agentic-jp.com) suite of Japanese data\nAPIs. Every call is settled per-use over the **x402** payment protocol — no\naccount, no subscription, no API key.\n\n## What it covers — 28 tools across 7 APIs\n\n| API | Tools | What it does |\n|---|---|---|\n| **address** | `address_normalize`, `address_geocode`, `address_reverse_geocode`, `address_postal_code`, `address_parse` | Japanese address normalization, geocoding, postal-code lookup, free-form parsing |\n| **furigana** | `furigana_convert`, `furigana_name_readings`, `furigana_classify` | Reading conversion, name readings, text classification |\n| **transit** | `transit_station_status`, `transit_line_disruptions`, `transit_route_plan`, `transit_alternative_routes`, `transit_lines`, `transit_stations_search` | Real-time rail delays + delay-aware route planning (ODPT) |\n| **diet** | `diet_member`, `diet_members_search`, `diet_minutes_search` | National Diet members and full-text proceedings search |\n| **holiday** | `holiday_is_holiday`, `holiday_list`, `holiday_add_business_days`, `holiday_business_days_between` | Public holidays + business-day math |\n| **weather** | `weather_forecast`, `weather_warnings`, `weather_areas` | JMA forecasts and warnings |\n| **houjin** | `houjin_corporation`, `houjin_search`, `houjin_verify`, `houjin_kyb_report` | Corporate-number (法人番号) registry — 5.78M corporations, one-call KYB report |\n\n## How payment works\n\nx402 is a **buyer-pays** protocol. This MCP server holds **your** wallet and pays\neach API call transparently — the agent never sees a payment prompt. Calls cost\nroughly **$0.001–$0.10 each** (mostly sub-cent), settled in USDC on Base.\n\n- You fund a wallet with a small amount of USDC.\n- You set `EVM_PRIVATE_KEY` to that wallet's key.\n- The server pays as it goes; per-call cost is well under a cent for most tools.\n\nWithout `EVM_PRIVATE_KEY` the server still starts and lists every tool, but a\npaid tool call returns a clear \"payment not configured\" message — nothing is\ncharged.\n\n> **Security:** the key in `EVM_PRIVATE_KEY` can spend that wallet's funds. Use a\n> dedicated wallet funded with only what you intend to spend — never a primary\n> wallet.\n\n## Setup\n\nNo install step — `npx` fetches and runs the server on demand.\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"japan-data\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mameta/japan-data-mcp\"],\n      \"env\": {\n        \"EVM_PRIVATE_KEY\": \"0xYOUR_FUNDED_WALLET_KEY\"\n      }\n    }\n  }\n}\n```\n\nWithout `EVM_PRIVATE_KEY` the server still starts and lists all 28 tools;\nthe paid tools then return a clear \"payments disabled\" error instead of\nrunning. Add a USDC-funded wallet key to enable them.\n\n### Cursor / Cline\n\nPoint the MCP client at `npx -y @mameta/japan-data-mcp` with the same\n`EVM_PRIVATE_KEY` env var. Transport is stdio.\n\n### From source\n\n```bash\ngit clone https://github.com/Mameta29/japan-data-mcp.git\ncd japan-data-mcp\nnpm install && npm run build\n# then point the MCP client at: node /abs/path/to/dist/index.js\n```\n\n## Example prompts\n\nOnce connected, just ask the agent in natural language:\n\n- \"「東京都千代田区丸の内1-1」を正規化して緯度経度も出して\" — `address_normalize` + `address_geocode`\n- \"Is tomorrow a public holiday in Japan? If so, when is the next business day?\" — `holiday_is_holiday` + `holiday_add_business_days`\n- \"山手線いま遅れてる?渋谷から東京駅までの代替ルートは?\" — `transit_line_disruptions` + `transit_alternative_routes`\n- \"Look up the corporation with corporate number 7010401056220\" — `houjin_corporation`\n- \"国会で「デジタル庁」がいつどの委員会で議論されたか調べて\" — `diet_minutes_search`\n\n## Configuration\n\n| Env var | Required | Description |\n|---|---|---|\n| `EVM_PRIVATE_KEY` | for paid tools | Private key of a USDC-funded wallet (Base / Polygon). Paid tools are disabled if absent. |\n\n## Development\n\n```bash\nnpm run dev        # run from source with tsx\nnpm run typecheck  # tsc --noEmit\nnpm run build      # compile to dist/\n```\n\n## License\n\nApache-2.0\n",
  "bytes": 4670,
  "sha": "8199af5f24038f6430f92fb78c066793e08697e05247ad80d70b0562b6d205e3",
  "repo_slug": "mameta29/japan-data-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mameta29_japan_data_mcp_4cf53627/readme"
}