Japan MCP Server

日本の公的データ(統計・法人・不動産)にAIからアクセスするMCPサーバー。e-Stat統計API・法人番号Web-API・不動産情報ライブラリAPIの3API統合。全国約1,700市区町村対応。

Local serverstdioPython

What is the Japan MCP server?

日本の公的データ(統計・法人・不動産)にAIからアクセスするMCPサーバー。e-Stat統計API・法人番号Web-API・不動産情報ライブラリAPIの3API統合。全国約1,700市区町村対応。. The japan mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 14 defined tools rather than through you.

What it actually does

日本の公的データ(統計・法人・不動産)にAIからアクセスするMCPサーバー。e-Stat統計API・法人番号Web-API・不動産情報ライブラリAPIの3API統合。全国約1,700市区町村対応。

Its toolset

Everything the assistant can do here goes through one of these:

  • search_statistics — キーワードで統計表を検索
  • get_regional_data — 指定地域の統計データを取得(summary=True で最新データのみ)
  • compare_regions — 複数地域のデータを比較(ピボットテーブル)
  • get_meta_info — 統計表のメタ情報(分類コード体系)を確認
  • resolve_area — 地域名 → 地域コードを検索
  • list_available_stats — 統計分野コードの一覧を表示
  • get_population — 地域の人口データを自動取得(プリセット)
  • get_regional_profile — 地域の総合プロファイルを自動取得(プリセット)
  • search_corporations — 法人名で企業を検索(地域・種別で絞り込み可)
  • get_corporation — 法人番号から企業の詳細情報を取得
  • search_invoice_by_name — 会社名からインボイス登録番号を検索(法人のみ)
  • check_invoice_registration — 登録番号(T+13桁)でインボイス登録状況を確認

Adding it to your client

Installation goes through your MCP client rather than a global install: point it at japan-data-mcp on PyPI and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Configuration

You will need 3 environment variables: ESTAT_APP_ID, CORP_APP_ID, REALESTATE_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

When to reach for it

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Japan's toolset — search_statistics, get_regional_data, compare_regions and 11 more — is a fair guide to whether it matches your workflow. It is maintained by Izyuusya; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Japan.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the japan mcp server does with a few real requests.

Available tools

ToolWhat it does
search_statisticsキーワードで統計表を検索
get_regional_data指定地域の統計データを取得(summary=True で最新データのみ)
compare_regions複数地域のデータを比較(ピボットテーブル)
get_meta_info統計表のメタ情報(分類コード体系)を確認
resolve_area地域名 → 地域コードを検索
list_available_stats統計分野コードの一覧を表示
get_population地域の人口データを自動取得(プリセット)
get_regional_profile地域の総合プロファイルを自動取得(プリセット)
search_corporations法人名で企業を検索(地域・種別で絞り込み可)
get_corporation法人番号から企業の詳細情報を取得
search_invoice_by_name会社名からインボイス登録番号を検索(法人のみ)
check_invoice_registration登録番号(T+13桁)でインボイス登録状況を確認
validate_invoice_on_date指定日時点でのインボイス登録有効性を確認
get_real_estate_transactions不動産取引価格情報を取得(価格サマリー付き)

How to install the Japan MCP server

### pip でインストールした場合

```json
{
  "mcpServers": {
    "japan-data-mcp": {
      "command": "japan-data-mcp",
      "env": {
        "ESTAT_APP_ID": "あなたのアプリケーションID",
        "CORP_APP_ID": "あなたのアプリケーションID(任意)",
        "REALESTATE_API_KEY": "あなたのAPIキー(任意)"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
ESTAT_APP_IDConfiguration value read at startup.Optional
CORP_APP_IDConfiguration value read at startup.Optional
REALESTATE_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Japan to search statistics.
  • Use Japan to get regional data.
  • Use Japan to compare regions.

Frequently asked questions

It connects Japan to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (search_statistics, get_regional_data, compare_regions, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Japan directly.