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 集成