MCP Server

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"
      }
    }
  }
}

{
  "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.

Parameter	Type	Description
`file_path`	string	Absolute path to the PDF file on your local machine
`api_key`	string	Your 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.

Parameter	Type	Description
`job_id`	string	The job ID returned by a previous extraction
`api_key`	string	Your 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.

Getting started

Guides

Installation

Configuration

Claude Code

Cursor

Available tools

`extract_invoice`

`get_job`

Example workflow

Verify the connection

Troubleshooting

​Installation

​Configuration

​Claude Code

​Cursor

​Available tools

​extract_invoice

​get_job

​Example workflow

​Verify the connection

​Troubleshooting

Installation

Configuration

Claude Code

Cursor

Available tools

`extract_invoice`

`get_job`

Example workflow

Verify the connection

Troubleshooting