Japan Public Data (法人番号・登録支援機関・官公需入札)

io.github.takaratomitaPublished by GitHub account takaratomitav0.1.0Updated Oct 27, 2026

Japan public data: corporate numbers, registered support organizations, government bid notices.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for Japanese public data: corporate number lookups, registered support organizations, and government bid notices.

What you can do
  • Look up Japanese companies by 13-digit corporate number or name, returning name, address and status
  • Search the registry of Registered Support Organizations for Specified Skilled Workers by name, prefecture/city and supported language
  • Search local government and national agency bid and tender notices by keyword, prefecture, issuing organization and notice date, with title, dates and notice link
When to use it
Useful when an assistant needs verified Japanese company details, information on organizations supporting foreign workers, or current public-sector tender opportunities in Japan. All three tools are read-only lookups.
Requirements
A remote Streamable HTTP endpoint; no authentication or API key is needed for clients. The server itself calls the National Tax Agency corporate number API and the KKJ portal search API.
Before you install
Read-only, but queries are sent to the server and onward to the National Tax Agency and KKJ APIs, so search terms are visible to those third parties. The bundled support-organization data is a snapshot that is refreshed periodically, so results may lag the official registry.

Installation

In SourceWeft

  1. Open Japan Public Data (法人番号・登録支援機関・官公需入札) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.takaratomita%2Fmcp-tools/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "japan-public-data": {
      "type": "http",
      "url": "https://mcp-tools.takara0408103123.workers.dev/mcp"
    }
  }
}

README

mcp-tools

日本の公開データを提供するリモートMCPサーバー(Streamable HTTP・Cloudflare Workers)。Claude Connectors Directory と ChatGPT Apps Directory への掲載を目的とする。

仕様・進捗は mcp-tools-spec.md を参照。

ツール

ツール内容状態
lookup_corporate_number国税庁 法人番号公表サイトAPI。法人番号(13桁)または法人名で検索実装済み
search_support_orgs出入国在留管理庁「登録支援機関登録簿」。名称・所在地・対応言語で検索(同梱データ。data/support-orgs.json)実装済み
search_local_govt_bids官公需情報ポータルサイト検索API(中小企業庁)。自治体・国の機関の入札・公募情報をキーワード・都道府県・機関名・公告日で検索実装済み

すべて読み取り専用(readOnlyHint: true)。外部通信は api.houjin-bangou.nta.go.jp と www.kkj.go.jp のみ。

登録支援機関データの更新

登録簿は随時更新される(2026-10 時点で月に複数回)。Worker から直接取得せず、生成済みJSONを同梱している。理由は2つ。(1) 配布元が既定のUAを403で拒否する (2) 2.6MBのExcelをリクエストごとに解析するのは Workers には重い。同梱JSONは約5.0MB・gzip後約0.86MBで、Workers 無料プランのスクリプト上限(圧縮後3MB)に収まる。

pip install openpyxlpython3 scripts/build_support_orgs.py   # 掲載ページから最新のExcelを取得し data/support-orgs.json を上書きnpm test

代表者氏名の列はツールの用途に不要なため取り込まない。名称・支援事務所名の欄は登録簿の記載のまま返す。

使い方(インストール)

公開エンドポイントは https://mcp-tools.takara0408103123.workers.dev/mcp。認証は不要。

Claude Code:

claude mcp add --transport http mcp-tools https://mcp-tools.takara0408103123.workers.dev/mcp

Claude Desktop・claude.ai:設定の「コネクタ」→「カスタムコネクタを追加」に上のURLを入力する。

その他のMCPクライアント(Cursor・VS Code 等):Streamable HTTP のリモートサーバーとして上のURLを登録する。

公式 MCP Registry の登録名は io.github.takaratomita/mcp-tools(定義は server.json)。

エンドポイント

パス内容
/mcpMCP(Streamable HTTP・ステートレス・JSON応答)
/privacyプライバシーポリシー(/ も同内容)
/healthヘルスチェック

開発

npm installnpm test            # vitestnpm run typecheckcp .env.example .dev.vars   # HOUJIN_APP_ID を記入npm run dev         # http://localhost:8787/mcp

動作確認例:

curl -s -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \  localhost:8787/mcp -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

デプロイ(Cloudflare Workers)

  1. npx wrangler secret put HOUJIN_APP_ID(lookup_corporate_number に必要。未登録でも他の2ツールは動く)
  2. npm run deploy(既定は workers.dev。独自ドメインは任意で、wrangler.toml の routes を有効化する)
  3. https://<host>/health と https://<host>/privacy が200を返すことを確認する

2026-10-19 に https://mcp-tools.takara0408103123.workers.dev へデプロイ済み。ディレクトリ側の要件に独自ドメインは含まれないため、workers.dev のまま掲載する(根拠は仕様書の章5)。

掲載チェックリスト

Claude Directory 掲載用

  • 公開HTTPSでデプロイ済み(workers.dev。/mcp 到達確認済み)
  • 有料 Claude プランに加入済み(Max。2026-10-19 に提出画面で確認)
  • 法人番号APIの appId を発行し、wrangler secret に登録済み(審査員が全ツールを試すため提出前に必須)
  • tools/list の3ツールすべてに readOnlyHint 等のannotationがある
  • プライバシーポリシーURL(/privacy)を用意
  • サポート連絡先(GitHub Issues)を記載
  • https://claude.ai/directory/manage の「MCPコネクタ」から提出(文面は docs/listings.md)

ChatGPT Apps 掲載用

  • 公開HTTPSでデプロイ済み(workers.dev)
  • ChatGPT Platform(https://platform.openai.com/plugins)にログインし、individual または business の本人確認を完了
  • 法人番号APIの appId を発行・登録済み
  • プライバシーポリシーURLを用意(/privacy)
  • CSP定義(接続先ドメインの宣言。外部通信は api.houjin-bangou.nta.go.jp と www.kkj.go.jp)を提出時に入力
  • 審査用のテストプロンプトと期待結果を用意
    • 「法人番号7000012050002の会社を調べて」→ 国税庁(東京都千代田区)
    • 「横浜市でネパール語に対応している登録支援機関を探して」→ 登録簿の該当機関一覧と出典
    • 「東京都の清掃業務の入札情報を探して」→ 直近30日の公告一覧と出典
  • 提出時点の最新要件を公式ガイドで再確認

ライセンス

MIT。データの出典は次のとおり。

  • 法人情報:国税庁法人番号公表サイト
  • 登録支援機関:出入国在留管理庁「登録支援機関登録簿」(公共データ利用規約 第1.0版(PDL1.0)。加工して利用)
  • 入札・公募情報:官公需情報ポータルサイト(https://www.kkj.go.jp/s/)の検索APIを利用

Source: README.md at commit 7bb111f

Tools

3

lookup_corporate_number

Lookup Japanese corporate number

Look up Japanese companies in the National Tax Agency Corporate Number Publication Site. Search by 13-digit corporate number, or by company name. Returns name, address and status. 国税庁 法人番号公表サイトから、法人番号(13桁)または法人名で法人情報(名称・所在地・閉鎖有無)を検索します。

Parametersnamenumber

search_support_orgs

Search Japanese registered support organizations (SSW)

Search the Immigration Services Agency of Japan registry of Registered Support Organizations for Specified Skilled Workers. Filter by name, location (prefecture/city in head office or support office address) and supported language. Organizations that reported suspension are excluded unless includeSuspended is true. 出入国在留管理庁「登録支援機関登録簿」から、特定技能外国人の登録支援機関を名称・所在地・対応言語で検索します(同梱データ・基準日あり)。

ParametersnamelimitlanguagelocationincludeSuspended

search_local_govt_bids

Search Japanese public procurement notices

Search bid and tender notices from Japanese local governments and national agencies via the KKJ (官公需情報ポータルサイト) search API by the Small and Medium Enterprise Agency. Filter by keywords (AND), prefecture, issuing organization and notice date. Returns title, organization, dates and the notice URL. 官公需情報ポータルサイトの検索APIで、自治体・国の機関の入札・公募情報をキーワード・都道府県・機関名・公告日で検索します。

Parameterslimitquerysinceprefectureorganization

Version history

1
  1. v0.1.0LatestOct 22, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts