Skip to main content
Glama
mcp-proofjson

mcp-proofjson

by proofjson

mcp-proofjson

A local MCP server (stdio) that lets AI agents produce and verify structured JSON outputs — with explicit scope, checks performed, checks not performed and human-confirmation requirements, instead of opaque yes/no answers.

The first live pack focuses on invoice assessment before payment: given supplied invoice data, context and policy, it returns allow / review / block with reasons and confidence. Works in Claude Desktop, Cursor and other MCP clients.

Scope (v1): supplied_data_only. It assesses the supplied data and configured policy. It does not independently verify supplier IBAN ownership, sanctions status, bank account ownership or external payment history unless external trust adapters are configured. allow is not a guarantee the invoice is safe.

Local stdio only — there is no public remote MCP until auth, rate limits, audit logs, terms and privacy are finalised.

Tools (exactly three)

  • assess_invoice_before_payment — returns allow / review / block with reasons, confidence, scope, checks_performed, checks_not_performed, human_confirmation_required.

  • verify_proofjson_proof — verify a proof for structure, hash consistency and signature validity. Does NOT verify the real-world truth of the underlying claim, invoice, supplier identity, IBAN ownership or sanctions status.

  • list_proofjson_packs — lists the live Pack Tasks.

This server does not expose arbitrary fetch, a browser, a shell, the filesystem, a generic HTTP proxy, a generic run endpoint, or any internal scoring.

Related MCP server: einvoice-mcp

Install & build

npm install
npm run build

Use in Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "proofjson": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/mcp-proofjson/dist/index.js"]
    }
  }
}

Use in Cursor

Add to .cursor/mcp.json (or Cursor Settings → MCP):

{ "mcpServers": { "proofjson": { "command": "node", "args": ["/ABSOLUTE/PATH/mcp-proofjson/dist/index.js"] } } }

Config

  • PROOFJSON_BASE (env) — defaults to https://proofjson.org.

Example

Ask your agent: "Assess this invoice before payment. Supplier ACME, amount 4250 EUR, invoice IBAN PT50…789, expected IBAN PT50…154." → the agent calls assess_invoice_before_payment → ProofJSON returns review because the IBAN differs from the expected IBAN supplied. The agent explains the result and recommends human confirmation.

Available Tools

3 tools
assess_invoice_before_paymentA

Assess invoice payment risk before paying, approving, scheduling or escalating an invoice. Returns a decision (allow | review | block) with reasons, confidence, scope, checks_performed, checks_not_performed and human_confirmation_required. ProofJSON v1 is supplied_data_only: it assesses the supplied invoice data, supplied context and configured policy. It does NOT independently verify supplier IBAN ownership, sanctions status, bank account ownership or external payment history unless external trust adapters are configured. allow is not a guarantee the invoice is safe.

Inputs: invoice (required), expected, policy, history.

list_proofjson_packsA

List the live ProofJSON Pack Tasks (verification capabilities). ProofJSON v1 is supplied_data_only: it assesses the supplied invoice data, supplied context and configured policy. It does NOT independently verify supplier IBAN ownership, sanctions status, bank account ownership or external payment history unless external trust adapters are configured. allow is not a guarantee the invoice is safe.

Inputs: no named parameters.

verify_proofjson_proofA

Verify a ProofJSON proof for structure, hash consistency and signature validity. This tool does NOT verify the real-world truth of the underlying claim, invoice, payment, supplier identity, IBAN ownership or sanctions status. ProofJSON v1 is supplied_data_only: it assesses the supplied invoice data, supplied context and configured policy. It does NOT independently verify supplier IBAN ownership, sanctions status, bank account ownership or external payment history unless external trust adapters are configured. allow is not a guarantee the invoice is safe.

Inputs: proof (required), expected_subject, expected_hash, options.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: assessing invoice risk, listing verification packs, and verifying proofs. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with snake_case (assess_invoice, list_proofjson_packs, verify_proofjson_proof).

    Tool Count4/5

    Three tools is slightly low but appropriate for the narrow scope of invoice risk assessment with ProofJSON v1. The set feels minimal but not insufficient.

    Completeness3/5

    The tools cover assessment, listing capabilities, and verification, but lack configuration, invoice management, or external verification tools. Gaps exist for a full workflow, but acceptable for a v1 limitation.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server for electronic invoicing that enables generating, validating, and parsing Factur-X and ZUGFeRD compliant XML invoices. It supports the French 2026 B2B reform and provides integration with Chorus Pro for automated invoice submission and status tracking.
      9
      12 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for German e-invoice compliance (XRechnung 3.0 & ZUGFeRD 2.x) enabling AI agents to validate, generate, parse, and check compliance of electronic invoices per EN 16931.
      6
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for e-invoice platforms. Enables natural language querying of invoices, partners, company data, and financial reports.
      18
      10 npm
      6
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      A fully local, closed-world MCP server that manages, validates, and serves bank-specific ISO 20022 clearing profiles and rule packs, enabling AI agents to discover profiles, fetch them, lint payloads against them, and validate rule-pack definitions.
      4
      30 PyPI
      1
      Apache 2.0