Receipt Extraction

What Receipt Extraction MCP server does

The Receipt Extraction MCP server accepts a receipt or invoice as a base64-encoded image or PDF and returns a versioned Receipt JSON object. The response can include vendor details, the vendor ABN and its validation status, document date, line items, GST values, totals, and a schema version.

Australian tax handling is part of the extraction result. The service checks ABNs using the 11-digit modulus-89 checksum and compares GST across line items and document totals. Each line item receives a tax_code, a confidence value from 0 to 1, and a short rationale describing the rule used. Entertainment-related expenses can be treated as non-creditable under the documented rules, while the stated incidental-to-travel exception can change the result when applicable.

How it works

Clients send the document content and MIME type to the hosted MCP endpoint. The available MCP tool is extract_receipt; a typical request supplies document_base64 and mime_type, such as image/jpeg or a PDF type. Tool discovery does not require an API key, but invoking the extraction tool does.

The same hosted service also provides an HTTPS API. Applications that prefer a typed JavaScript or TypeScript client can install @acjlabs/receipt-extraction-client and call extractReceipt with the base64 document and MIME type. The returned object is designed for downstream expense, accounting, or document-processing workflows, subject to the service's documented accuracy and tax-rule scope.

Setup and configuration

Use the live MCP endpoint at https://receipt-extraction.acjlabs.com/mcp. An alternate Workers URL reaches the same deployment. Authenticate requests with an Authorization: Bearer YOUR_API_KEY header. Clients that support remote HTTP MCP servers and custom headers can use the same endpoint and header configuration.

Free-tier keys are requested by sending an email address to POST /v1/signup. The response provides the key directly; it is shown once and cannot be recovered if lost. The free tier allows 20 documents per month without a card. Paid pricing is described as forthcoming in the source material.

For the npm client, install @acjlabs/receipt-extraction-client, then create a client with the hosted base URL and API key. The repository also provides a quickstart document and client-specific configuration examples.

Tools and capabilities

• extract_receipt for image and PDF extraction.
• Structured vendor, line-item, tax, and total fields.
• Australian ABN checksum validation.
• GST cross-checking across line items and totals.
• Per-line tax codes, confidence values, and rule rationales.
• HTTPS access in addition to MCP.

Limitations and notes

The Receipt Extraction MCP server applies publicly documented Australian GST and ABN rules; its output is software output, not tax advice. The repository reports validation against four hand-built readable test documents covering net-priced documents, GST-inclusive-only documents, invalid ABNs, and unreadable documents. Broader production accuracy across document formats is not yet established in the provided material.

The hosted implementation is not open source. The repository contains documentation for the service, while issues and feature requests can be submitted through the repository or by email. The alternate endpoint is provided for compatibility with existing configurations, not as a separate service.