Repository avatar
Other Tools
v0.1.0
active

jp-business-id

io.github.nick353/jp-business-id

Validate Japanese invoice registration numbers (T+13) and corporate numbers. No API key.

Documentation

Japan Business ID MCP

An MCP server that validates Japanese business identifiers, so an agent reading or issuing Japanese invoices catches typos before money moves:

  • Qualified invoice registration numbers (適格請求書発行事業者登録番号, T + 13 digits) — format, check digit, whether it is a corporation's number, and the official lookup URL
  • Corporate numbers (法人番号, 13 digits) — National Tax Agency check digit formula; on a typo it tells you the expected check digit
  • Build a corporate number from a 12-digit company registry number (会社法人等番号)
  • Extract every invoice / corporate number from invoice or contract text and validate them in one call

No API key, no sign-in, read-only. Full-width digits and hyphens are accepted.

A passing check digit means the number is well-formed, not that it is registered. Each result includes lookup_url on the official National Tax Agency site to confirm. The NTA does not publish a check scheme for sole proprietors' invoice numbers, so those are reported as "cannot be decided offline" instead of guessed.

Connect

Streamable HTTP endpoint: https://jp-business-id-mcp.nichika2000823.workers.dev/mcp

claude mcp add --transport http jp-business-id https://jp-business-id-mcp.nichika2000823.workers.dev/mcp

Any MCP client that supports remote (Streamable HTTP) servers works the same way: Cursor, VS Code, ChatGPT, Gemini CLI.

Tools

ToolWhat it does
validate_invoice_numberT8700110005901 → valid format, corporation, lookup URL
validate_corporate_number1700110005901 → invalid, expected check digit 8
corporate_number_from_base700110005901 → 8700110005901
extract_business_idsFind and validate all IDs in a document

日本語

インボイス登録番号(T+13桁)と法人番号を、国税庁の検査用数字の計算式で確かめる MCP サーバーです。請求書の文面からまとめて拾うこともできます。登録の有無は結果の lookup_url(国税庁の公表サイト)で確かめてください。

Privacy

Usage is counted with a salted hash of the caller that rotates every two weeks; raw IP addresses and the numbers you send are not stored.

Check digit formula: https://www.houjin-bangou.nta.go.jp/documents/checkdigit.pdf

MIT License.