Zovo Invoice Reader

Turns invoice PDFs into one spreadsheet and checks the tax, totals and money math of each invoice.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
88%
Naming quality
100%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,975Tokens (tool definitions)
~9.7 KBTypical response size
Moderate attention impact (1.54% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "invoice-reader": {
      "url": "https://invoice-reader.zovo.one/mcp"
    }
  }
}

Remote endpoints

https://invoice-reader.zovo.one/mcpstreamable-http

What it can do

Tool inventory

Tools (2)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢read_invoices(files)

Use this when the user attaches 1 to 20 invoice PDFs and wants them in a spreadsheet, wants invoice data extracted (vendor, invoice number, invoice date, due date, subtotal, tax or VAT or GST, shipping, discount, total, amount due, line items), or wants the invoice arithmetic checked. Returns one Excel workbook (Invoices and Line items sheets) and a ZIP of CSV files, plus per-invoice checks: lines add up to the subtotal, subtotal - discount + tax + shipping = total, quantity x unit price = amount. Each check is PASS, MISMATCH with the difference, or NOT CHECKABLE when a value is missing. Text-based PDFs only (no OCR), up to 10 MB and 20 pages per file. Does not pay, approve, or send invoices. Do not use for receipts photographed with a phone or for making a new invoice.

Input Schema

{
  "type": "object",
  "properties": {
    "files": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "download_url": {
            "type": "string",
            "description": "Temporary download link for the file, supplied by ChatGPT."
          },
          "file_id": {
            "type": "string",
            "description": "ChatGPT file id, e.g. file_abc123."
          },
          "mime_type": {
            "description": "Media type if known, e.g. application/pdf.",
            "type": "string"
          },
          "file_name": {
            "description": "Original file name if known, e.g. statement.pdf.",
            "type": "string"
          }
        },
        "required": [
          "download_url",
          "file_id"
        ]
      },
      "description": "The invoice PDFs, in any order, e.g. inv-1001.pdf, inv-1002.pdf. 1 to 20 files."
    }
  },
  "required": [
    "files"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "files": {
      "type": "number"
    },
    "invoices": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "file": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "vendor": {
            "type": [
              "string",
              "null"
            ]
          },
          "invoice_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "invoice_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "due_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "subtotal": {
            "type": [
              "string",
              "null"
            ]
          },
          "tax": {
            "type": [
              "string",
              "null"
            ]
          },
          "shipping": {
            "type": [
              "string",
              "null"
            ]
          },
          "discount": {
            "type": [
              "string",
              "null"
            ]
          },
          "total": {
            "type": [
              "string",
              "null"
            ]
          },
          "amount_due": {
            "type": [
              "string",
              "null"
            ]
          },
          "line_count": {
            "type": "number"
          },
          "checks": {
            "type": "object",
            "properties": {
              "lines_sum": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string"
                  },
                  "detail": {
                    "type": "string"
                  },
                  "difference": {
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "detail"
                ],
                "additionalProperties": false
              },
              "totals": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string"
                  },
                  "detail": {
                    "type": "string"
                  },
                  "difference": {
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "detail"
                ],
                "additionalProperties": false
              },
              "line_math": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string"
                  },
                  "detail": {
                    "type": "string"
                  },
                  "difference": {
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "detail"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "lines_sum",
              "totals",
              "line_math"
            ],
            "additionalProperties": false
          },
          "notes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "file",
          "status",
          "vendor",
          "invoice_number",
          "invoice_date",
          "due_date",
          "currency",
          "subtotal",
          "tax",
          "shipping",
          "discount",
          "total",
          "amount_due",
          "line_count"
        ],
        "additionalProperties": false
      }
    },
    "summary": {
      "type": "object",
      "properties": {
        "pass": {
          "type": "number"
        },
        "mismatch": {
          "type": "number"
        },
        "partial": {
          "type": "number"
        },
        "not_checkable": {
          "type": "number"
        },
        "scanned": {
          "type": "number"
        },
        "error": {
          "type": "number"
        }
      },
      "required": [
        "pass",
        "mismatch",
        "partial",
        "not_checkable",
        "scanned",
        "error"
      ],
      "additionalProperties": false
    },
    "totals_by_currency": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "currency": {
            "type": "string"
          },
          "invoices": {
            "type": "number"
          },
          "total": {
            "type": "string"
          }
        },
        "required": [
          "currency",
          "invoices",
          "total"
        ],
        "additionalProperties": false
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "downloads": {
      "type": "object",
      "properties": {
        "xlsx": {
          "type": "string"
        },
        "csv_zip": {
          "type": "string"
        }
      },
      "required": [
        "xlsx",
        "csv_zip"
      ],
      "additionalProperties": false
    },
    "invoices_count": {
      "type": "object",
      "properties": {
        "shown": {
          "type": "number"
        },
        "total": {
          "type": "number"
        }
      },
      "required": [
        "shown",
        "total"
      ],
      "additionalProperties": false
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "files",
    "invoices",
    "summary",
    "totals_by_currency",
    "warnings",
    "note"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
🟢check_invoice_math(lines, subtotal, discount, tax, shipping, ...)

Use this when the user types or pastes invoice amounts (line quantities, unit prices, line amounts, subtotal, discount, tax, shipping, total) and wants to know whether the invoice adds up. Returns PASS, MISMATCH with the difference in cents, or NOT CHECKABLE when a value is missing, for three checks: lines add up to the subtotal, subtotal - discount + tax + shipping = total, quantity x unit price = amount. Uses integer cent math. Does not read files (use read_invoices for PDFs), does not compute tax rates, and does not pay or send anything.

Input Schema

{
  "type": "object",
  "properties": {
    "lines": {
      "description": "Invoice lines, e.g. [{\"description\":\"Toner\",\"qty\":2,\"unit_price\":\"89.99\",\"amount\":\"179.98\"}]. Up to 500.",
      "maxItems": 500,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "description": {
            "description": "Line text, e.g. Toner cartridge.",
            "type": "string",
            "maxLength": 200
          },
          "qty": {
            "description": "Quantity, e.g. 2 or 1.5.",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 30
              },
              {
                "type": "number"
              }
            ]
          },
          "unit_price": {
            "description": "Unit price, e.g. 89.99.",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 40
              },
              {
                "type": "number"
              }
            ]
          },
          "amount": {
            "description": "Line amount, e.g. 179.98.",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 40
              },
              {
                "type": "number"
              }
            ]
          }
        }
      }
    },
    "subtotal": {
      "description": "Amount as printed, e.g. 406.73. Leave out when the invoice has none.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "number"
        }
      ]
    },
    "discount": {
      "description": "Amount as printed, e.g. 15.00. Leave out when the invoice has none.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "number"
        }
      ]
    },
    "tax": {
      "description": "Amount as printed, e.g. 33.56. Leave out when the invoice has none.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "number"
        }
      ]
    },
    "shipping": {
      "description": "Amount as printed, e.g. 9.95. Leave out when the invoice has none.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "number"
        }
      ]
    },
    "total": {
      "description": "Amount as printed, e.g. 440.29. Leave out when the invoice has none.",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "number"
        }
      ]
    },
    "decimal_mark": {
      "description": "Decimal mark of the amounts: \".\" for 1,234.56 or \",\" for 1.234,56. Default: decided from the values.",
      "type": "string",
      "enum": [
        ".",
        ","
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string"
    },
    "checks": {
      "type": "object",
      "properties": {
        "lines_sum": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string"
            },
            "detail": {
              "type": "string"
            },
            "difference": {
              "type": "string"
            }
          },
          "required": [
            "status",
            "detail"
          ],
          "additionalProperties": false
        },
        "totals": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string"
            },
            "detail": {
              "type": "string"
            },
            "difference": {
              "type": "string"
            }
          },
          "required": [
            "status",
            "detail"
          ],
          "additionalProperties": false
        },
        "line_math": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string"
            },
            "detail": {
              "type": "string"
            },
            "difference": {
              "type": "string"
            }
          },
          "required": [
            "status",
            "detail"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "lines_sum",
        "totals",
        "line_math"
      ],
      "additionalProperties": false
    },
    "lines_sum": {
      "type": [
        "string",
        "null"
      ]
    },
    "computed_total": {
      "type": [
        "string",
        "null"
      ]
    },
    "lines": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "line": {
            "type": "number"
          },
          "description": {
            "type": "string"
          },
          "qty": {
            "type": [
              "string",
              "null"
            ]
          },
          "unit_price": {
            "type": [
              "string",
              "null"
            ]
          },
          "amount": {
            "type": [
              "string",
              "null"
            ]
          },
          "check": {
            "type": "string"
          },
          "detail": {
            "type": "string"
          }
        },
        "required": [
          "line",
          "description",
          "qty",
          "unit_price",
          "amount",
          "check",
          "detail"
        ],
        "additionalProperties": false
      }
    },
    "lines_count": {
      "type": "object",
      "properties": {
        "shown": {
          "type": "number"
        },
        "total": {
          "type": "number"
        }
      },
      "required": [
        "shown",
        "total"
      ],
      "additionalProperties": false
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "status",
    "checks",
    "lines_sum",
    "computed_total",
    "lines",
    "note"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded2 tools