PlugRail JP Corporate

dev.plugrailPublished by plugrail.devOfficial publisherv0.1.1Updated Oct 24, 2026

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

The publisher's own server: PlugRail Japanese Calendar

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for looking up Japanese corporations and checking qualified invoice issuer numbers against National Tax Agency public data.

What you can do
  • Look up a single corporation by its 13-digit corporate number
  • Search corporations by prefecture plus company-name prefix, or by prefecture plus address prefix, with paging
  • Resolve a corporate number exactly, or explore name and address candidates with per-evidence scores instead of a single guess
  • Verify a qualified invoice issuer number (T plus 13 digits) for registration, cancellation or expiry with dates
  • Retrieve a company profile with basic information, subsidies, certifications and finance, flagging missing sections and their reasons
When to use it
Useful when an assistant needs to identify Japanese companies, confirm a corporate number, check whether a supplier's invoice registration is valid, or assemble a quick company profile from official public data.
Requirements
A remote Streamable HTTP endpoint; no local runtime or package. Works without an API key on the free tier; a Pro plan key is passed in the Authorization header. Network access to the hosted endpoint is required.
Before you install
Free tier is capped at 100 tool calls per calendar month, counted per IP address when no key is used, with a 10-per-minute rate limit; Pro costs ¥9,800 per month with no free trial and billing from the first month. The Authorization header carries a paid API key. Responses are not official government output and are not guaranteed; a not-found invoice number is not proof of invalidity, and individual sole proprietors are not covered.

Installation

In SourceWeft

  1. Open PlugRail JP Corporate 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/dev.plugrail%2Fjp-corporate/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": {
    "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 参照。

Source: jp-corporate/README.md at commit b89f42d

Tools

6

search_corporate_by_number

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

ParameterscorporateNumberrequired

search_corporate_by_name

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

Parameterslimitcursorprefixrequiredprefecturerequired

search_corporate_by_address

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

Parameterslimitcursorprefixrequiredprefecturerequired

lookup_corporate

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

ParametersnamelimitcursoraddressprefecturecorporateNumber

verify_invoice_number

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

ParametersinvoiceNumberrequired

company_profile

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

ParameterscorporateNumberrequired

Version history

2
  1. v0.1.1LatestOct 7, 2026
  2. v0.1.0Sep 24, 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

Other Plugrail integrations