Japan Corporate Number

@pipeworx/japan-corporate-number

Japan's National Tax Agency (国税庁) corporate-number register (法人番号公表サイト) — the complete spine of every 13-digit 法人番号 issued since 2015-10-05: legal name, katakana reading and English name when NTA holds one, address, corporate kind (stock company, LLC, government body, NPO, etc.) and status (active, or closed/merged with the narrative NTA published). 5,837,980 entities as of the 2026-09-30 cut.

Part of Pipeworx — an MCP gateway connecting AI agents to 1882+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

gBizINFO (mcps/gbizinfo, METI) is a different source hanging richer government records — procurement, subsidies, patents, financials — off the same corporate number, with partial coverage. This pack is the complete spine (every registered number, from NTA directly); use gbizinfo for the government-record detail once you have a number.

Tools

• jp_corporate_number(number) — look up one entity by its 13-digit 法人番号. Validates the check digit before looking up (see "Check digit" below) and returns found: false with a reason for a malformed number, a check-digit failure, or a correctly-formed number simply not in the register — never an empty object.
• jp_company_search(name, prefecture?, limit?) — search by Japanese name (substring; 株式会社, (株), ㈱, 有限会社, 合同会社 etc. accepted as prefix or suffix), the English name/katakana reading NTA published for some entities, or the English name GLEIF holds for entities with an LEI. prefecture accepts a Japanese name, an English name, or a 2-digit code. Results carry lei and matched_via (register_name or gleif_lei_bridge); the response carries name_bridge.status.

Auth

Keyless. The gateway supplies the data directly — no caller-facing key, and no vendor key of any kind (the register is published as a monthly file, not a live API). The tools work only through the hosted gateway: a standalone build has no data to read and returns a loud error (StoreUnavailableError) naming that, never an empty result.

Data source & reuse terms

• Japan National Tax Agency (国税庁), Corporate Number Publication Site (法人番号公表サイト) — the whole-country corporate-number register, published monthly. Pipeworx loads each monthly edition; data_as_of on every response is when the loaded edition was taken. The fetch mechanics (and the verified column mapping) live only in scripts/japan-corporate-number/README.md, which does not publish — CLAUDE.md step 9b (a4c024647): name the source, never the source file/path/form fields.
• Terms of use (Japan's Public Data License v1.0, quoted from NTA's terms-of-use page): attribution is required ("本コンテンツを利用する際は出典を記載してください" — when using this content, state the source); edits/derivative processing must be disclosed separately from the attribution; and edited/processed data must never be presented as though the government itself produced it ("編集・加工等した情報を、あたかも国（又は府省等）が作成したかのような 態様で公表・利用することは禁止します"). Otherwise permissive — commercial reuse and redistribution are not restricted. This README and every tool response carry the source and data_as_of; the data is NTA's, reformatted by Pipeworx, never presented as government-produced.

Kind codes (法人種別)

The complete set observed: 101 national government organization, 201 local government, 301 Kabushiki Kaisha (stock company), 302 Godo Kaisha (LLC-equivalent), 303 Gomei Kaisha, 304 Goshi Kaisha, 305 other registered corporation (e.g. incorporated association/foundation), 399 other, 499 foreign company etc. Labels are best-effort English glosses of NTA's standard code table; the raw code is always returned alongside the label.

ステータス — 実際に陥りやすい誤り（その中にもう一つ）

合併によって閉鎖された法人（process_type 71/72、約31,000件）には、他方の当事者を示す日本語の文が入った closure_event_text がありますが、これらの行では closure_date と closure_cause_code は NULL です。この2項目はまったく別の閉鎖方式（主に process_type 21、約784K件）で設定されており、そちらには closure_event_text がないことがほとんどです。closure_date だけを確認すると、合併によって消滅した法人をすべて見落とします。

この誤りに潜むもう一つの落とし穴：closure_event_text はどちら側からの合併についても記述されており、どちら側かは文言でしか判別できません。「...を合併」（他方を吸収）は存続法人を示します（例：子会社を吸収するトヨタ自動車株式会社）。「...に合併し解散」（他方に合併して消滅）は、消滅した法人を示します。closure_event_text があれば閉鎖とみなすのは誤りです。稼働中の企業を閉鎖済みと報告するケースが実際に見つかりました。status が closed_or_merged になるのは、closure_date が設定されている場合、または closure_event_text が設定され、かつ文字列に「解散」が文字どおり含まれている場合です。

チェックデジット

法人番号の先頭桁は、残りの12桁（上位桁から順）に対するチェックデジットです。重みは 2,1,2,1,...（最上位の基準桁の重みは2）で、合計値を9で割った余りを求め、チェックデジットは 9 - (sum mod 9) です。登記簿にある実際の番号（1000012160153、1000013050386、1000013050394）で検証済みです。すべて正しく、素朴な「教科書どおり」の重み付け 1,2,1,2,... では3件とも不正になります。jp_corporate_number は検索前にこれを検証するため、形式不正または成立し得ない番号には、単なる「見つかりません」ではなく、具体的な理由 bad_format / bad_check_digit が返されます。

「日本語とローマ字表記による検索」の内容と対象外

GLEIF 名称ブリッジ（フリート #3020）。 NTA が英語名を公開しているのは580万件のうち15,352件だけで、Sharp、Sony Group、Toyota Motor の英語名はありません。そのため、検索のたびに GLEIF（Global Legal Entity Identifier Foundation）の LEI レコードに対して、日本に絞り込んだライブ呼び出しも1回行います。日本の法人について、GLEIF は登録機関 RA000412 の下で会社法人等番号を記録しています。法人番号は、この12桁の番号の先頭に NTA のチェックデジットを付けたものなので、GLEIF の各検索結果は番号によって登記簿の行に照合できます。同じ名称の階層では、ブリッジで照合された行が登記簿のみの行より上位に並びます。これにより、100社以上ある「シャープ」を含む会社の中で、Sharp Corporation が先頭に表示されます。このブリッジはライブのプロキシ呼び出し（データはコピーしません）であり、障害時も検索を継続します。GLEIF が利用できない場合、検索は登記簿のみを対象に回答し、name_bridge.status: "unavailable" と示します。

jp_company_search は、日本語の主要名称（法人格を除去し、例：「株式会社」/「K.K.」はどちらも除外）、英語名、カタカナ読みを対象とする単一の FTS5 トライグラムインデックスを検索します。いずれかは、NTA がその法人について実際に公開しているものです。これは音訳機能ではありません。登録済みの英語名やカナがない会社は、NTA が記録していないローマ字表記の検索では見つかりません。ただし、下記の GLEIF ブリッジ経由の場合を除きます。prefecture は、静的な47都道府県テーブル（src/prefectures.ts）を使って照合されるため、一致した会社が英語の住所を登録しているかどうかにかかわらず、日本語名、英語名、コードで指定できます。登記簿の会社ごとの prefecture_en 列で直接絞り込むと、英語名をまったく持たない会社が大半を占める都道府県では、ほとんどすべての法人が気付かれないまま除外されてしまいます。

FTS5 のトライグラムトークナイザーは、バイトではなく文字単位で区切ります。3文字未満の検索語ではトライグラムが生成されず、実際の部分文字列であっても MATCH では一致しません（同じ文字列を使った場合、2文字の日本語検索では FTS 経由で0件、LIKE 経由では5件以上返されることを確認済みです）。jp_company_search は、3文字未満の検索語に対して単純な部分文字列スキャンに切り替えます。

更新と重複チェックについては、scripts/japan-corporate-number/README.md（運用者専用、公開されません）および上記の gbizinfo を参照してください。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "japan-corporate-number": {
      "url": "https://gateway.pipeworx.io/japan-corporate-number/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/japan-corporate-number/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールに加えて、共通ツールが約 30 個表示されます。接続時の initialize レスポンスには正確な範囲が記載されており、その日の状況を知るための正式な情報源です。

これは意図的な設計であり、誤って多重化されているわけではありません。メタツールを使うことで、このパックが対象としていない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を通じて回答できるため、MCP サーバーを追加する必要がありません。現時点では、メタツールなしでパックのエンドポイントを利用する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利便性を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1882 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/jp_corporate_number \
  -H 'Content-Type: application/json' \
  -d '{"number":"1000012160153"}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/jp_corporate_number を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントもゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "japan-corporate-number": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-japan-corporate-number"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-japan-corporate-number

stdin／stdout を介して MCP で通信し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは、上記のパックエンドポイントとフルゲートウェイのどちらでも利用できます。

ask_pipeworx({ question: "your question about Japan Corporate Number data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT