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

{
  "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