io.github.vladic-corp/denpyo-mcp (MCP) — Denpyo OCR + T-number Verification

This MCP server provides Japanese invoice/receipt OCR and tax verification. It reads documents from local files or URLs, converts them into structured JSON (including vendor/merchant, line items, and 8%/10% consumption-tax breakdown), and extracts the qualified-invoice registration number (T+13 digits) for verification.

🛠️ Key Features

OCR for Japanese invoices (請求書) and receipts (領収書)
Input from local files or URLs
Structured JSON output with vendor/merchant and line items
Consumption tax breakdown for 8% and 10%
Extracts T+13 digitインボイス登録番号 and verifies it against the National Tax Agency registry
Uses x402 for per-call payment

🚀 Use Cases

Converting Japanese invoices/receipts into structured data for downstream processing
Validating the qualified-invoice registration number during document ingestion

⚡ Developer Benefits

No signup and no API keys (wallet as the account)
Single call that both extracts and verifies the registration number

⚠️ Limitations

Focused on Japanese invoice/receipt OCR and T-number (qualified-invoice registration number) verification
Payment is per call via x402

denpyo-mcp

MCP server for Denpyo — Japan Invoice & Receipt Reader API (https://denpyo-api.hp-vladic.workers.dev).

OCR Japanese invoices (請求書) and receipts (領収書) from local files or URLs into structured JSON — vendor/merchant, line items, 8%/10% consumption-tax breakdown — with the qualified-invoice registration number (インボイス登録番号, T+13 digits) extracted and verified against the National Tax Agency registry in the same call.

Pays per call via x402 (USDC on Base or Solana). The wallet is the account — no signup, no API keys.

Usage

json

{
  "mcpServers": {
    "denpyo": {
      "command": "npx",
      "args": ["-y", "denpyo-mcp"],
      "env": { "EVM_PRIVATE_KEY": "0x... (Base wallet holding USDC)" }
    }
  }
}

Solana instead: set SVM_PRIVATE_KEY (base58) rather than EVM_PRIVATE_KEY.

Tools

Tool	Cost	What it does
`read_japan_invoice`	$0.04	Invoice (local file path or URL) → structured JSON + NTA verification. First 2 pages
`read_japan_receipt`	$0.03	Receipt (photo/PDF, local path or URL) → structured JSON + NTA verification. First page
`verify_japan_invoice_number`	$0.01	Registry-only check of a T+13-digit number, optional name match
`denpyo_catalog`	free	Machine-readable service catalog

Example prompts once connected: "Read C:\scans\invoice-0712.pdf and tell me if the issuer is a registered qualified-invoice issuer" / "Process every receipt photo in this folder and total the deductible amounts by tax rate."

Failed analyses (unreadable files) return errors and are not charged. Documents are processed transiently and never stored.

Sister package: kaisha-mcp — Japan company registry lookups, new-company feeds, business-day math.

MIT — vladic-corp/denpyo-api

io.github.vladic-corp/denpyo-mcp