PlugRail JP Corporate

dev.plugrail由 plugrail.dev 發布官方發布者v0.1.1更新於 Oct 24, 2026

Search Japanese corporations and verify invoice numbers using official National Tax Agency data.

發布方自己的服務:PlugRail Japanese Calendar

已驗證Streamable HTTP可網頁執行金融商業與電商

概覽

AI 產生的概覽

託管型 MCP 伺服器,依日本國稅廳公開資料查詢日本法人並核驗合格發票發行事業者編號。

可以做什麼
  • 以 13 位法人編號查詢單一法人
  • 依都道府縣加法人名稱前綴,或都道府縣加地址前綴搜尋法人,支援分頁
  • 對法人編號做確定查詢,或對名稱與地址做候選探索並回傳分項依據評分
  • 核驗合格發票發行事業者編號(T 加 13 位)的登記、取消或失效狀態與日期
  • 依法人編號取得公司檔案,含基本資訊、補助金、申報與財務,並標示缺漏部分及原因
適用情境
適合需要辨識日本企業、確認法人編號、查核供應商發票登記是否有效,或依官方公開資料快速整理公司檔案的場合。
執行需求
遠端 Streamable HTTP 端點,不需本機執行環境或安裝套件。免費額度不需 API 金鑰;Pro 方案的的金鑰透過 Authorization 標頭傳入。需要能連線至該託管端點的網路。
安裝前請注意
免費額度為每個曆月 100 次工具呼叫,無金鑰時依 IP 位址計算,且每分鐘限 10 次;Pro 為每月 9,800 日圓,無免費試用,首月即計費。Authorization 標頭承載付費 API 金鑰。回應並非政府官方輸出且不保證正確;發票編號查無資料不等於無效,個人事業者資料不在收錄範圍。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 PlugRail JP Corporate,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/dev.plugrail%2Fjp-corporate/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "plugrail-jp-corporate": {
      "type": "http",
      "url": "https://jp-corporate.plugrail.dev/mcp"
    }
  }
}

README

PlugRail JP Corporate

English | 日本語

English

MCP server for searching Japanese corporations and verifying invoice registration numbers, built on official Japan National Tax Agency (NTA) public data.

What it can do

ToolWhat it does
search_corporate_by_numberFind one corporation by its 13-digit corporate number.
search_corporate_by_nameSearch by 2-digit prefecture code + company-name prefix (up to 20 results).
search_corporate_by_addressSearch by 2-digit prefecture code + address prefix (up to 20 results).
lookup_corporateExact lookup by corporate number, or candidate search by name/address. A name alone never resolves to a single company; candidates are returned with per-evidence scores.
verify_invoice_numberCheck a qualified invoice issuer number (T + 13 digits): registered / cancelled / expired with dates. A "not found" result is reported as "not published or not yet recorded" — never as "invalid" or "non-existent".
company_profileCompany profile (basic info, subsidies, certifications, finance) by 13-digit corporate number. Each section carries its source, freshness, and missing-reason; partial failures return what was fetched plus what is missing.

Every successful response carries its data source and a disclaimer; error responses carry the disclaimer. This service is not an official service of the NTA or any other government body, and its responses do not represent their official views.

Usage

The server is a hosted Streamable HTTP endpoint. You can connect without an API key and use the free tier; a Pro plan API key removes the monthly cap.

sh
# Free tier (no key)claude mcp add --transport http jp-corporate https://jp-corporate.plugrail.dev/mcp
# Pro planclaude mcp add --transport http jp-corporate https://jp-corporate.plugrail.dev/mcp \  --header "Authorization: Bearer <YOUR_PRO_KEY>"

Then ask things like "look up corporate number 7000012050002" or "find companies in Tokyo starting with 渋谷".

Limits

  • Free tier: all tools, up to 100 tool calls per calendar month (JST), no credit card. Counted per IP address without a key. tools/list is not counted. The 101st call returns an error pointing to https://plugrail.dev/pricing.
  • Rate limits per minute: 10 without a key, 600 on Pro. Exceeding it returns rate_limited (HTTP 429) with a retry hint.
  • Name/address search is prefix match only (no nationwide fuzzy search), max 20 results per call with cursor pagination.
  • Some company_profile sections from gBizINFO may be returned as missing with a reason; the response always states what is missing.

Pricing

  • Free: 100 tool calls / month (calendar month, JST), no API key or credit card required.
  • Pro: ¥9,800 / month, tax-inclusive (total display including consumption-tax equivalent; tax-exempt operator). No monthly cap.
  • No free trial of Pro (billing starts in the first month). Details: https://plugrail.dev/pricing

Sources and disclaimer

This is not an official service of the National Tax Agency or any other Japanese government body. Information provided does not represent their official views and is not guaranteed by them.

Support

Contact: [email protected] (email only; replies within 2 business days, Japanese or English; best effort, no SLA). Terms: https://plugrail.dev/legal/terms. Privacy: see PRIVACY.md.

License

MIT. See LICENSE.

日本語

国税庁の公式公開データを基に、日本の法人検索とインボイス登録番号の照合を行う MCP サーバーです。

できること

ツール内容
search_corporate_by_number法人番号 (13桁) で1件検索
search_corporate_by_name都道府県コード2桁 + 法人名の接頭辞で検索 (最大20件)
search_corporate_by_address都道府県コード2桁 + 所在地の接頭辞で検索 (最大20件)
lookup_corporate法人番号の確定照会と名称・所在地の候補探索を分離。名称だけでは断定せず複数候補と根拠別スコアを返す
verify_invoice_number適格請求書発行事業者番号 (T+13桁) の登録・取消・失効を日付付きで照合。未発見は「非掲載または未収録」と明示し「無効」「不存在」と断定しない
company_profile法人番号 (13桁) で基本情報・補助金・届出・財務のプロファイル。各領域の出典・鮮度・欠損を保持し、部分障害時は取得済みと欠損を同時に返す

成功レスポンスには必ず出典と免責文言が付きます。本サービスは国税庁その他の行政機関の公式サービスではなく、応答はそれらの公式見解を示すものではありません。

使い方

ホスト型 Streamable HTTP エンドポイントです。API キーなしで接続して無料枠を使えます。Pro プランの API キーを付けると月間上限がなくなります。

sh
# 無料枠(キーなし)claude mcp add --transport http jp-corporate https://jp-corporate.plugrail.dev/mcp
# Pro プランclaude mcp add --transport http jp-corporate https://jp-corporate.plugrail.dev/mcp \  --header "Authorization: Bearer <proキー>"

「法人番号 7000012050002 の会社を調べて」「東京都で『渋谷』から始まる会社を探して」のように話しかけると対応するツールが呼ばれます。

制限

  • 無料枠: 全ツール利用可・月100回まで(暦月・日本時間)・カード不要。キーなしは IP アドレス単位で数えます。tools/list は数えません。101回目は https://plugrail.dev/pricing への案内付きエラーになります。
  • 分間レート制限: キーなし 10回/分、Pro 600回/分。超えると rate_limited(HTTP 429)と再試行の目安を返します。
  • 名称・所在地検索は接頭辞一致のみ (全国ファジー検索なし)。1回最大20件、カーソルページング。
  • company_profile の gBizINFO 由来の領域は、取得できない場合に理由付きで missing を返します。

料金

  • 無料: 月100回まで(暦月・日本時間)。API キー・カード不要。
  • Pro: 月額 9,800円(税込。消費税相当額を含む総額表示。免税事業者)。月間上限なし。
  • Pro の無料トライアルはありません(初月から課金)。詳細: https://plugrail.dev/pricing

出典・免責

本サービスは国税庁その他の行政機関の公式サービスではありません。提供情報はそれらの公式見解を示すものではなく、正確性を保証するものでもありません。

サポート

連絡先: [email protected](メールのみ・営業日48時間以内・日英対応・ベストエフォートで SLA なし)。利用規約: https://plugrail.dev/legal/terms 。プライバシー: PRIVACY.md。

ライセンス

MIT。LICENSE 参照。

來源:jp-corporate/README.md,提交 b89f42d

工具

6

search_corporate_by_number

法人番号(13桁)で日本の法人を1件検索します。国税庁公開データに基づきます。入力例: {"corporateNumber": "1180301018771"}

輸入參數corporateNumber必填

search_corporate_by_name

都道府県+法人名の接頭辞で日本の法人を検索します。国税庁公開データに基づきます。入力例: {"prefecture": "13", "prefix": "渋谷", "limit": 10}

輸入參數limitcursorprefix必填prefecture必填

search_corporate_by_address

都道府県+所在地の接頭辞で日本の法人を検索します。国税庁公開データに基づきます。市区町村名の前方一致が主経路で、町名以降を含む指定(例: 港区港南・東京都港区港南)は住所全文の前方一致へ迂回し、町名のみの断片(例: 港南)は住所全文の部分一致で拾います。入力例: {"prefecture": "13", "prefix": "渋谷", "limit": 10}

輸入參數limitcursorprefix必填prefecture必填

lookup_corporate

法人番号の確定照会と名称・所在地の候補探索を分離して返す。名称だけでは断定せず複数候補と根拠別scoreを返す。候補探索は name 指定時は prefecture 任意(省略時は全国前方一致で searchedNationwide:true・候補に県コード付き・県か住所を足すと絞り込める)。prefecture は '13' または '東京都' のどちらでも可。address が「東京都渋谷区…」のように都道府県名で始まれば prefecture は省略可(推定)。address のみの検索は prefecture または推定が必須(全国非対応)。番号確定例: {"corporateNumber": "1180301018771"}/候補例: {"name": "渋谷", "prefecture": "13", "limit": 10}/全国例: {"name": "山田工業"}

輸入參數namelimitcursoraddressprefecturecorporateNumber

verify_invoice_number

適格請求書発行事業者番号(T+13桁)の登録・取消・失効を日付付きで照合します。本サービスは法人・人格のない社団等のデータのみを取り込み、個人事業者のデータを取り込んでいないため、個人事業者の番号はここでは見つかりません(公表サイト https://www.invoice-kohyo.nta.go.jp/ では確認できる場合があります)。未発見を無効・不存在と断定しません。登録ありの応答には法人番号データ由来の法人名 name・所在地 address を含みます(法人番号表に無い場合は null。未発見の応答は name/address ともに null)。入力例: {"invoiceNumber": "T1180301018771"}

輸入參數invoiceNumber必填

company_profile

法人番号(13桁)で基本情報・補助金・届出・財務の会社プロファイルを返す。各領域の出典・鮮度・欠損を保持し、部分障害時は取得済みと欠損を同時に返す。入力例: {"corporateNumber": "1180301018771"}

輸入參數corporateNumber必填

版本歷史

2
  1. v0.1.1最新Oct 7, 2026
  2. v0.1.0Sep 24, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Plugrail 整合