japan-data-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CORP_APP_ID | No | Corporate Number Web-API application ID. Optional; also used for the invoice API. | |
| ESTAT_APP_ID | Yes | e-Stat API application ID. Required for the server to start. | |
| REALESTATE_API_KEY | No | Real estate information library API key. Optional. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_statisticsA | キーワードで統計表を検索する. Args: keyword: 検索キーワード(例: "人口", "国勢調査", "県内総生産") survey_years: 調査年で絞り込み(例: "2020", "2015-2020") stats_field: 統計分野コードで絞り込み(例: "02"=人口・世帯)。 list_available_stats で分野一覧を確認できます。 limit: 取得件数上限(デフォルト10) Returns: 検索結果の統計表一覧(ID・統計名・タイトルなど) |
| get_regional_dataA | 指定した地域の統計データを取得し、整形して返す. コード番号は自動的に人間が読める名称に変換される。 Args: stats_data_id: 統計表ID(search_statistics で取得) area: 地域名(例: "東京都")または地域コード(例: "13000") tab_code: 表章項目コード(特定の指標に絞り込む場合) time_code: 時間軸コード(特定の年に絞り込む場合) cat01_code: 分類事項01コード(特定のカテゴリに絞り込む場合) limit: 取得件数上限(デフォルト1000) summary: Trueの場合、最新時点の主要指標のみ返す(データ量を大幅に削減) Returns: 整形済みの統計データ(マークダウンテーブル) |
| compare_regionsA | 複数地域の統計データを比較する. 時間軸(年)を行、地域を列にしたピボットテーブルを生成。 Args: stats_data_id: 統計表ID(search_statistics で取得) areas: 比較する地域名のリスト(例: ["東京都", "大阪府", "愛知県"]) tab_code: 表章項目コード(特定の指標に絞り込む場合) cat01_code: 分類事項01コード(特定のカテゴリに絞り込む場合) Returns: 地域比較のピボットテーブル(マークダウン) |
| search_corporationsA | 法人名で企業を検索する. 国税庁の法人番号公表サイトから法人情報を検索。 地域や法人種別で絞り込み可能。 Args: name: 検索キーワード(法人名、部分一致) area: 地域名で絞り込み(都道府県名、例: "東京都") kind: 法人種別で絞り込み("01"=国の機関, "02"=地方公共団体, "03"=設立登記法人, "04"=その他) limit: 取得件数上限(デフォルト10、最大2000) Returns: 法人情報の一覧(マークダウンテーブル) |
| get_corporationA | 法人番号から企業の詳細情報を取得する. 13桁の法人番号を指定して、法人の正式名称・所在地・種別などを取得。 Args: corp_number: 法人番号(13桁の数字) Returns: 法人の詳細情報(マークダウン) |
| get_real_estate_transactionsA | 不動産取引価格情報を取得する. 国土交通省の不動産情報ライブラリから、指定地域の不動産取引データを取得。 取引種別・価格・面積・建築年・最寄駅などの情報を含む。 Args: area: 地域名(例: "東京都", "水戸市")または地域コード year: 取引年で絞り込み(例: 2023) quarter: 四半期で絞り込み(1〜4) Returns: 不動産取引データの一覧と価格サマリー(マークダウン) |
| check_invoice_registrationA | 適格請求書発行事業者の登録情報を登録番号で確認する. インボイス制度に基づく適格請求書発行事業者の登録状況・ 名称・所在地などを確認できる。 Args: number: 登録番号(T+13桁の数字、例: "T1234567890123")。 カンマ区切りで最大10件まで同時に検索可能。 history: 変更履歴を含めるか(デフォルト: False) Returns: 登録事業者の情報(マークダウン) |
| validate_invoice_on_dateA | 指定日時点での適格請求書発行事業者の登録有効性を確認する. 特定の取引日に事業者がインボイス発行資格を持っていたかを確認できる。 Args: number: 登録番号(T+13桁の数字、例: "T1234567890123") day: 確認日(YYYY-MM-DD形式、例: "2024-12-01") Returns: 指定日時点の登録状態(マークダウン) |
| search_invoice_by_nameA | 会社名からインボイス登録番号を検索する. 法人番号APIで会社名を検索し、該当法人のインボイス登録状況を 自動で確認する。法人番号 → 登録番号(T+法人番号)の変換を 内部で行うため、登録番号を知らなくても検索できる。 ※ 個人事業主は法人番号を持たないため、このツールでは検索できません。 個人事業主の場合は登録番号(T+13桁)を直接指定して check_invoice_registration をご利用ください。 Args: name: 検索キーワード(会社名、部分一致) area: 地域名で絞り込み(都道府県名、例: "東京都") limit: 取得件数上限(デフォルト5、最大10) Returns: インボイス登録情報の一覧(マークダウン) |
| resolve_areaA | 地域名から e-Stat の地域コードを検索する. 都道府県名の部分一致で検索可能。 「東京」→「東京都 (13000)」のように接尾辞なしでもマッチする。 Args: name: 地域名(例: "東京", "大阪府", "北海") Returns: マッチした地域名と地域コードの一覧 |
| list_available_statsA | 利用可能な統計分野の一覧を表示する. search_statistics の stats_field パラメータに使えるコードの一覧。 Returns: 統計分野コードと名称の一覧 |
| get_meta_infoA | 統計表のメタ情報(分類コード体系)を取得する. 統計表にどのような次元(地域・時間・カテゴリ等)があるか、 各次元にどのようなコードが定義されているかを確認できる。 データ取得前の下調べに便利。 Args: stats_data_id: 統計表ID(search_statistics で取得) Returns: 分類オブジェクトの一覧(各次元のコード→名称マッピング) |
| get_populationA | 地域の人口データを自動取得する(プリセット). 統計表IDを知らなくても、地域名を指定するだけで 人口推計や国勢調査から人口推移データを取得できる。 Args: area: 地域名(例: "東京都")または地域コード(例: "13000") Returns: 人口推移の整形済みレポート(マークダウン) |
| get_regional_profileB | 地域の総合プロファイルを自動取得する(プリセット). 人口・経済・労働など複数分野の統計データを自動検索・取得し、 1つのレポートにまとめる。地域の概要を素早く把握したいときに便利。 Args: area: 地域名(例: "東京都")または地域コード(例: "13000") Returns: 地域の総合プロファイル(マークダウン) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Most tools have clearly distinct purposes, and the descriptions help separate similar actions. A few pairs could be confused—search_corporations vs. search_invoice_by_name, and check_invoice_registration vs. validate_invoice_on_date—but their intent is still discernible.
The tools almost all follow a snake_case verb_noun pattern, which is predictable and readable. Minor deviations like validate_invoice_on_date and search_invoice_by_name add prepositional modifiers, and check/validate are near-synonyms, so the consistency is not perfect.
14 tools is well within a reasonable scope for a multi-domain Japan data server covering statistics, corporate records, real estate, and invoice registration. Each tool serves a distinct purpose, including presets that add convenience without bloating the set.
The server covers core end-to-end workflows: search/retrieve statistics, resolve codes, get metadata, compare regions, look up companies, fetch real estate transactions, and verify invoice registrations. Minor gaps exist, such as limited real-estate filtering and no area-only corporate browsing, but agents can work around them.