Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.parzo.dev/llms.txt

Use this file to discover all available pages before exploring further.

Parzo ships a native MCP (Model Context Protocol) server. Once installed, your AI agent can extract invoice data without writing a single line of integration code — just point it at a PDF and ask.

Installation

Install the MCP server globally via npm:
npm install -g parzo-mcp

Configuration

Claude Code

Add Parzo to your Claude Code MCP config file:
{
  "mcpServers": {
    "parzo": {
      "command": "parzo-mcp",
      "env": {
        "PARZO_API_KEY": "inv_your_key_here"
      }
    }
  }
}
Replace inv_your_key_here with your Parzo API key. Get one free →

Cursor

Add the following to your Cursor MCP settings:
{
  "mcpServers": {
    "parzo": {
      "command": "parzo-mcp",
      "env": {
        "PARZO_API_KEY": "inv_your_key_here"
      }
    }
  }
}

Available tools

extract_invoice

Extracts structured data from an invoice PDF file.
ParameterTypeDescription
file_pathstringAbsolute path to the PDF file on your local machine
api_keystringYour Parzo API key (optional if set via env)
Example prompt:
Extract the invoice data from /Users/me/invoices/acme-april.pdf
The agent will call extract_invoice, poll for the result, and return the full JSON — vendor, buyer, line items, financials, and validation flags.

get_job

Retrieves the status and result of an existing extraction job.
ParameterTypeDescription
job_idstringThe job ID returned by a previous extraction
api_keystringYour Parzo API key (optional if set via env)
Example prompt:
Get the result of job 3419ae1e-93c3-48a1-95ac-833c390f9916

Example workflow

Once Parzo is connected, you can use natural language to process invoices:
I have 3 invoices in ~/Downloads/invoices/. 
Extract the data from each one and give me a summary 
of the total amount due and due dates.
The agent will automatically call extract_invoice for each file and synthesize the results.

Verify the connection

After adding the config, restart your client and run:
List the available Parzo tools
You should see extract_invoice and get_job listed.

Troubleshooting

“Missing X-API-Key header” — Make sure your API key is set correctly in the env block of your config file. “File not found” — Use the absolute path to the PDF. On Windows with WSL, use /mnt/c/Users/... format. Server not showing up — Restart your MCP client after editing the config file.
The MCP server is open source and published on npm as parzo-mcp. Found a bug? Open an issue on GitHub.