jp-pint-mcp

MCP server that lets AI agents validate Japanese qualified invoices (適格請求書) and registration numbers (T+13) — including real-existence verification against the National Tax Agency (国税庁) public registry — via jp-pint. Zero dependencies.

Setup

Get a free key (200 validations/month) at https://jp-pint-rryxbfcsxq-an.a.run.app. Add to your MCP client config:

{
  "mcpServers": {
    "jp-pint": {
      "command": "npx",
      "args": ["github:junju523/jp-pint-mcp"],
      "env": { "JP_PINT_KEY": "jpp_live_..." }
    }
  }
}

Related MCP server: calendar-mcp

Tools

• check_registration_number(number) — validate a 適格請求書発行事業者登録番号 ("T" + 13 digits): format + 法人番号 check digit, plus real-existence verification against the 国税庁 public registry (does it exist / still valid / registered name). (No key required.)

• validate_invoice(invoice) — validate the mandatory fields of a qualified invoice and 8%/10% tax consistency. (Uses JP_PINT_KEY.)

Privacy

Sends only the data you pass to the jp-pint API; invoice contents are not stored. Results are advisory — confirm final tax treatment with a professional.

License

MIT

Need a custom MCP server or AI integration?

I build production MCP servers, LLM/API integrations, and automation, and keep them reliable with strict schemas, eval gates, and monitoring. If you want something like this for your stack:

• Email: j.sano@jam-on.jp

• Upwork: https://www.upwork.com/freelancers/~011037e81e494ba5bb

• More: https://github.com/junju523