Skip to main content
Glama
Japan Business ID MCP

Japan Business ID MCP

by nick353

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.

Related MCP server: JP Invoice & Tax MCP

Tools

Tool

What it does

validate_invoice_number

T8700110005901 → valid format, corporation, lookup URL

validate_corporate_number

1700110005901 → invalid, expected check digit 8

corporate_number_from_base

700110005901 → 8700110005901

extract_business_ids

Find 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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides Japanese tax and invoice utilities such as consumption tax calculation, withholding tax, invoice number validation, and tax rate summarization, enabling AI assistants to perform these operations locally without external APIs.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to perform Japanese invoice and tax calculations, including consumption tax, withholding tax, invoice number validation, and invoice data generation, all locally without external APIs.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to validate a Japanese qualified invoice against the six required items, reduced-rate markings, per-rate totals, and once-per-invoice-per-rate tax rounding, while flagging the common line-by-line rounding mistake, and to normalize and verify T + 13-digit registration numbers. Read-only tools also compute expected consumption tax for a given amount, rate, price basis, and rounding method.
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to identify Japanese companies by name, look up corporate numbers, addresses, and qualified invoice registration status, and batch-match company lists using read-only tools.
      4
      257 npm
      MIT