Bango API（法人番号・インボイス）

bango-mcp

Bango API の公式 MCP サーバーです。Claude・Cursor などの AI アシスタントに話しかけるだけで、日本の会社の法人番号・所在地・インボイス（適格請求書発行事業者）の登録状況を調べられます。

あなた：「サンプル商事って大阪の会社の法人番号わかる？」AI    ：bango_find_company で候補を探し、所在地とインボイスの登録状況まで答えます
あなた：「この請求書の T1180301018771、去年の10月1日時点で有効だった？」AI    ：bango_check_invoice でその日付時点の有効性を確認します
あなた：「この取引先リスト30社に法人番号を付けて」AI    ：bango_match_companies でまとめて名寄せし、確実な一致と要確認を分けて返します

できること（ツール）

• 「株式会社／㈱」「全角／半角」「ハイフン入りの番号」などは自動で吸収します。
• 候補が複数あるときは、AI が勝手に1社に決めずにあなたへ確認するよう設計しています。
• すべて読み取り専用です。データの変更や外部への送信は行いません。

はじめかた

1. APIキーを取る（無料）

bango-api.jp/signup で登録し、ダッシュボード で APIキーを発行します。新規登録すると30日間Proプラン無料トライアルが自動で始まり、通常APIは月500,000回、名寄せは月10,000件まで試せます。クレジットカードの登録は不要で、自動で課金されることはありません。終了後は Free プラン（月500回、名寄せ月50件）で続けて使えます（料金）。

2. AI アシスタントに登録する

Node.js 20 以上が必要です。

Claude Code

claude mcp add bango -e BANGO_API_KEY=あなたのAPIキー -- npx -y bango-mcp

Claude Desktop（設定 → 開発者 → 設定を編集 で claude_desktop_config.json を開く）

{  "mcpServers": {    "bango": {      "command": "npx",      "args": ["-y", "bango-mcp"],      "env": { "BANGO_API_KEY": "あなたのAPIキー" }    }  }}

Cursor（~/.cursor/mcp.json またはプロジェクトの .cursor/mcp.json）

{  "mcpServers": {    "bango": {      "command": "npx",      "args": ["-y", "bango-mcp"],      "env": { "BANGO_API_KEY": "あなたのAPIキー" }    }  }}

VS Code・Windsurf など他の MCP クライアントも、同じ npx -y bango-mcp と環境変数 BANGO_API_KEY で動きます。

3. 話しかける

• 「トヨタ自動車の法人番号と本社所在地を教えて」
• 「T1180301018771 は今も有効？」
• 「この5社がインボイス登録しているか一覧にして：…」
• 「スプレッドシートの取引先名に法人番号を付けたい。要確認のものは候補も出して」

設定

データの出典

国税庁法人番号システム Web-API 機能および国税庁適格請求書発行事業者公表システム Web-API 機能を利用して取得した情報をもとに、Bango API が編集・加工して提供しています。内容は国税庁によって保証されたものではありません。

開発

npm installnpm test          # ユニットテスト（実際のAPIは呼びません）npm run build     # dist/ に出力BANGO_API_KEY=... npx @modelcontextprotocol/inspector node dist/index.js   # 手元で動作確認

不具合や要望は Issues へ。お問い合わせ: [email protected]

リリースやデータ更新のお知らせは公式X @bangoapi で発信しています。

English

Official MCP server for Bango API. It lets AI assistants identify Japanese companies by name (fuzzy matching) and look up corporate numbers (法人番号), addresses and qualified-invoice (T-number) registration status.

Tools: bango_find_company, bango_get_company, bango_check_invoice, bango_match_companies (all read-only).

claude mcp add bango -e BANGO_API_KEY=your_key -- npx -y bango-mcp

Get a free API key at https://bango-api.jp/signup (new sign-ups get a 30-day Pro trial, no credit card required). Updates: @bangoapi on X. License: MIT.