mcpField
D
denpyo-mcp

denpyo-mcp

Local
github.com/vladic-corpFinance0Updated 15w ago
Repository

About denpyo-mcp

denpyo-mcp is an MCP server for extracting structured data from Japanese invoices and receipts, with registration-number verification. It accepts files or URLs and charges per call through x402; documents are processed transiently, not stored.

Key features

  1. 01Read Japanese invoices and receipts
  2. 02Extract merchants, items, and tax
  3. 03Verify registration numbers and names
  4. 04Accept local files and URLs
  5. 05Pay per call via x402

Use cases

  1. 01Structure invoice and receipt data
  2. 02Total deductible receipts by tax rate
  3. 03Check whether an issuer is registered

MCP support

The MCP server provides tools to read invoices and receipts, verify registration numbers, and retrieve a service catalog. Analysis is paid per call through x402.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "vladic-corp-denpyo": {
      "command": "npx",
      "args": [
        "-y",
        "denpyo-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "SVM_PRIVATE_KEY": "<SVM_PRIVATE_KEY>"
      }
    }
  }
}
Run commandnpx -y denpyo-mcp
Environment variables to set
EVM_PRIVATE_KEYSecretBase wallet private key holding USDC (0x...). Provide this or SVM_PRIVATE_KEY.
SVM_PRIVATE_KEYSecretSolana wallet private key holding USDC (base58). Provide this or EVM_PRIVATE_KEY.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmdenpyo-mcp0.1.1

Tools

4

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
urlstringNoPublic http(s) URL of the invoice document (alternative to file)
filestringNoLocal path to the invoice file (PDF/JPEG/PNG/TIFF/HEIF)

Details

From the project README

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

ToolCostWhat it does
read_japan_invoice$0.04Invoice (local file path or URL) → structured JSON + NTA verification. First 2 pages
read_japan_receipt$0.03Receipt (photo/PDF, local path or URL) → structured JSON + NTA verification. First page
verify_japan_invoice_number$0.01Registry-only check of a T+13-digit number, optional name match
denpyo_catalogfreeMachine-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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.