# Parseo MCP by usefulapi

> Parseo MCP by usefulapi is a freemium MCP server for finance and payments. Hosted MCP server to upload invoices for OCR and export them from Parseo to accounting. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/parseo/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/parseo
- **MCP Registry name:** io.usefulapi/parseo
- **Categories:** finance and payments
- **Listing updated:** 2026-11-18

## About

The server lets an AI client talk to a Parseo account over the Model Context Protocol. Once connected, it can upload invoice files for OCR, track each processing job until it finishes, and read the extracted invoice with its line items.

It also covers the back-office steps around the data. Invoices can be listed by export state and exported in accounting formats such as Odoo or Rivile, corrections can be sent field by field, and clients and buyer or supplier contacts can be created and updated. The README notes that the server is hosted, so there is nothing to install locally; sign-in happens through OAuth with your own Parseo API key.

The tool set has 27 tools, 15 read-only and 8 that change data, with the rest covering usage, plan management and feature requests. It suits bookkeepers and accounting teams who already use Parseo and want an AI assistant to handle routine invoice work.

## Features

- **Invoice OCR upload:** Sends PDF, PNG, JPG or WebP invoices, one at a time or in batches of up to 10, for extraction.
- **Job status tracking:** Polls upload jobs and reports whether they are queued, completed, failed or waiting for credits.
- **Accounting export:** Exports processed invoices as JSON, XML or formats for accounting systems such as Odoo and Rivile.
- **Invoice field correction:** Updates only the extracted fields that need fixing, and flags exported invoices that were changed afterwards.
- **Client and contact management:** Lists, creates and updates end clients and buyer or supplier contacts for each invoice.
- **Audit log access:** Queries the team audit log for actions such as invoice creation or API key rotation.

## Good for

- Upload a batch of supplier invoices and check when each one has been processed
- List invoices not yet exported and push them into an Odoo or Rivile import
- Correct wrong totals or fields on extracted invoices without opening the web app
- Check credit balance and find uploads that are waiting for credits
- Create client records so new invoices are assigned to the correct customer

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http parseo https://parseo.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://parseo.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "parseo": {
      "url": "https://parseo.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "parseo": {
      "type": "http",
      "url": "https://parseo.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "parseo": {
      "serverUrl": "https://parseo.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "parseo": {
      "type": "http",
      "url": "https://parseo.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `parseo_upload_invoice`: Upload one invoice file (PDF, PNG, JPG or WebP, up to 7.5 MB) for OCR.
- `parseo_upload_invoices_batch`: Upload up to 10 invoice files in one call.
- `parseo_list_invoices`: List invoices of the client in use, with filters for status, direction, export state, dates, amounts and names.
- `parseo_get_invoice`: Get one invoice with its extracted data, line items, export block and assignment status.
- `parseo_export_invoice`: Export one invoice as JSON, XML or an accounting-system format such as rivile, odoo or b1.
- `parseo_update_invoice`: Correct the extracted fields of one invoice.
- `parseo_mark_invoice_exported`: Record that your system imported an invoice so it leaves the export queue.
- `parseo_list_jobs`: List upload jobs with their status.
- `parseo_get_job`: Get one upload job.
- `parseo_list_clients`: List the clients of the team.
- `parseo_get_client`: Get one client with its company details.
- `parseo_create_client`: Create a client.
- `parseo_update_client`: Change the details of one client.
- `parseo_list_contacts`: List buyer and supplier contacts.
- `parseo_get_contact`: Get one contact.
- `parseo_create_contact`: Create a buyer or supplier contact for one client.
- `parseo_update_contact`: Change the details of one contact.
- `parseo_list_audit_logs`: Query the team audit log.
- `parseo_get_key_info`: Show the team, plan, scopes and rate limit of the API key in use.
- `parseo_get_credit_balance`: Show the credit balance and this billing cycle's usage.
- `parseo_get_quota`: Show credits, plan limits and current usage.
- `parseo_get_usage`: Show invoice usage per day for the last N days.
- `parseo_get_invoice_status`: Get the processing status of one invoice.
- `parseo_usage_status`: Report the caller's current usage and whether the limit is reached.
- `parseo_request_feature`: Tell usefulapi that a needed capability is missing from the Parseo tools.
- `parseo_upgrade`: Get a paid Pro or Pro+ plan for Parseo.
- `parseo_cancel_subscription`: Cancel the Pro subscription at the end of the paid period.

## FAQ

### Is this an official Parseo product?

No. The README and listing state that usefulapi is an independent service and is not affiliated with or endorsed by Parseo.

### Which AI clients can connect to it?

Any client that supports remote MCP servers over Streamable HTTP with OAuth login, including Claude, ChatGPT, Claude Code, Codex, Cursor and VS Code.

### Can the AI change data in my Parseo account?

Yes, if you approve it. Eight of the 27 tools can create or change data; the other 15 are read-only, and most clients ask for approval before a tool call runs.

### What does it cost?

A free plan allows 50 tool calls per month. Pro is $9 per month or $90 per year for 10,000 calls, and Pro+ is $39 per month or $390 per year for 100,000 calls.

### Is Parseo MCP by usefulapi free?

Parseo MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Parseo MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http parseo https://parseo.usefulapi.io/mcp

### What are the best alternatives to Parseo MCP by usefulapi?

The closest alternatives to Parseo MCP by usefulapi are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/parseo-mcp-by-usefulapi
