What it does
billparse is a small local bridge to the hosted InvoiceParserPro MCP service. It exposes four tools that work on invoice PDFs, scans and photos supplied as a URL, base64 data or an attached file. invoice_to_excel returns header fields and line items with download links to an .xlsx and a CSV file. check_invoice tests whether the quantities, prices, subtotal, tax, and total add up, and lists every problem it finds. extract_invoice_data returns structured JSON with confidence figures overall and per field. get_result retrieves the outputs of a document already submitted, using the job_id from an earlier call. Nothing is parsed on the local machine: the server answers the tool list locally and forwards each tool call unchanged to the hosted endpoint.
It suits teams that receive invoices in mixed formats and need the figures in a spreadsheet or in structured form, or that want to verify invoice arithmetic before filing. Requesting another output for a document already processed can use get_result instead of submitting the same file again.
Running it means installing the package through npm or a container and adding it to an MCP client configuration, or using the single binary from the command line, where each tool is a subcommand that takes a JSON argument string. The hosted endpoint can be overridden with an environment variable, and an optional API key is sent as a bearer header when set. Sessions are opened on first use and reused for the rest of the process. Exit codes distinguish success, upstream errors and usage errors.
Limitations and requirements
Parsing happens on the hosted InvoiceParserPro service, so the bridge needs network access to that endpoint and documents are sent to it. The API key is optional; when it is not set, no key header is sent. The source states that download links stay valid for 60 minutes without signing in. Upstream failures, including JSON-RPC errors, non-2xx responses and unreadable bodies, are returned as error results whose text starts with 'billparse error:'. The endpoint override variable and the bearer header format were added in a rebuild and are not part of the original capture.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.CloudCorpRecords/billparse
Turn invoice PDFs, scans and photos into checked spreadsheets and structured data.
v0.1.0As shown on registry.modelcontextprotocol.io when we last read it