Parseo MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.0.1Updated Nov 7, 2026

Upload invoices for OCR; read, export and correct extracted invoices in Parseo.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFiles & StorageData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted Parseo server that lets an assistant upload invoices for OCR, track jobs, and read, export or correct the extracted invoice data.

What you can do
  • Upload single or batch invoice files (PDF, PNG, JPG, WebP) for OCR and poll the resulting jobs
  • List, read and check the status of invoices, including extracted fields and line items
  • Export invoices as JSON, XML or accounting formats and mark them as exported
  • Create and update clients and buyer or supplier contacts
  • Query audit logs and review credit balance, quota and daily usage
  • Manage the subscription and send feature requests
When to use it
Useful when you want an assistant to process incoming invoices end to end: send files for OCR, wait for results, check totals, correct extracted fields, and push data into an accounting system. Also handy for monitoring credits and usage of a Parseo account.
Requirements
Remote MCP endpoint; no local install. Sign-in is via OAuth with your Parseo credentials, and on first connect you provide a Parseo API key (from Parseo settings) plus an optional client id for a team-wide key. No keys go in the client config. A Parseo account and plan are needed; the free plan allows 50 tool calls per month.
Before you install
Write tools create and change data: uploading invoices, editing extracted fields, creating or updating clients and contacts, and marking invoices exported. Uploads consume credits. The server stores your Parseo API key per user. Subscription tools can start a paid plan through a payment link and cancel it, with no refund for the current period. Confirm before any write action.

Installation

In SourceWeft

  1. Open Parseo MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fparseo/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Parseo MCP by usefulapi

Use your Parseo account from Claude, Cursor, or any MCP client. Upload invoices for OCR, follow the jobs, and read, export and correct the extracted invoices. Hosted, no local install: connect with your own credentials.

Live endpoint: https://parseo.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://parseo.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http parseo https://parseo.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "parseo": {      "url": "https://parseo.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Parseo credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/parseo/

On first connect you provide a Parseo API key (Parseo → Settings → API Keys) and an optional client id (cl_…) for a team-wide key. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
parseo_get_key_inforeadGet API key info
parseo_get_credit_balancereadGet credit balance
parseo_get_quotareadGet quota snapshot
parseo_get_usagereadGet usage metrics
parseo_list_invoicesreadList invoices
parseo_get_invoicereadGet an invoice
parseo_get_invoice_statusreadGet invoice status
parseo_export_invoicereadExport an invoice
parseo_list_jobsreadList ingestion jobs
parseo_get_jobreadGet an ingestion job
parseo_list_clientsreadList clients
parseo_get_clientreadGet a client
parseo_list_contactsreadList contacts
parseo_get_contactreadGet a contact
parseo_list_audit_logsreadList audit log
parseo_upload_invoicewriteUpload an invoice
parseo_upload_invoices_batchwriteUpload several invoices
parseo_update_invoicewriteUpdate an invoice
parseo_mark_invoice_exportedwriteMark an invoice as exported
parseo_create_clientwriteCreate a client
parseo_update_clientwriteUpdate a client
parseo_create_contactwriteCreate a contact
parseo_update_contactwriteUpdate a contact
parseo_usage_statusmetaUsage status (free-tier meter)
parseo_request_featuremetaRequest a missing feature
parseo_upgrademetaUpgrade to Pro or Pro+
parseo_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with parseo_upgrade (it returns a Stripe Checkout link). Cancel any time with parseo_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running parseo_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/parseo/README.md at commit 2450437

Tools

23

parseo_get_key_info

Get API key info

Show the team, plan, scopes and rate limit of the API key in use. Good first call to check that the key works. Parseo: GET /me.

Takes no parameters.

parseo_get_credit_balance

Get credit balance

Show the credit balance, the low-balance threshold and this billing cycle's usage. Jobs with awaiting_credits wait for this balance to rise. Parseo: GET /me/credits.

Takes no parameters.

parseo_get_quota

Get quota snapshot

Show credits, plan limits and current usage in one reply. Parseo: GET /me/quota.

Takes no parameters.

parseo_get_usage

Get usage metrics

Show invoice usage per day for the last N days (1-90). Parseo: GET /usage.

Parametersdays

parseo_list_invoices

List invoices

List invoices of the client in use, with filters for status, direction, export state, dates, amounts and names. The list omits line items: fetch one invoice for its full content. Requires invoice:read. Parseo: GET /invoices.

Parameterssortlimitcursorexpandstatuscurrencyexportedclient_iddirectiontotal_maxtotal_minbuyer_name+7 more

parseo_get_invoice

Get an invoice

Get one invoice with its extracted data, line items, export block and assignment status. Use it after a job completes (invoiceId). Requires invoice:read. Parseo: GET /invoices/{id}.

Parametersexpandfieldsclient_idinvoice_idrequired

parseo_get_invoice_status

Get invoice status

Get the processing status of one invoice (queued, processing, processed or failed). Requires invoice:read. Parseo: GET /invoices/{id}/status.

Parametersclient_idinvoice_idrequired

parseo_export_invoice

Export an invoice

Export one invoice as JSON (default), XML, or an accounting-system format (for example rivile, odoo, b1). Non-JSON formats return the text in 'body'. Fetching does not mark the invoice as exported. Requires invoice:export. Parseo: GET /invoices/{id}/export.

Parametersformatclient_idinvoice_idrequired

parseo_list_jobs

List ingestion jobs

List upload jobs with their status (processing, awaiting_credits, completed, failed). Use it to find a job that has no invoice yet. Parseo: GET /jobs.

Parameterslimitcursorstatusclient_idcreated_tocreated_from

parseo_get_job

Get an ingestion job

Get one upload job. Poll it until status is completed (invoiceId is set), failed (error is set) or awaiting_credits (parked until credits arrive, not an error). Parseo: GET /jobs/{jobId}.

Parametersjob_idrequired

parseo_list_clients

List clients

List the clients (end customers) of the team. Each client has an id (cl_...) for X-Client-Id. Requires client:read. Parseo: GET /clients.

Parameterslimitcursor

parseo_get_client

Get a client

Get one client with its company details. Requires client:read. Parseo: GET /clients/{id}.

Parametersclient_idrequired

parseo_list_contacts

List contacts

List buyer and supplier contacts, optionally for one client. Requires contact:read. Parseo: GET /contacts.

Parameterslimitcursorclient_id

parseo_get_contact

Get a contact

Get one contact (buyer or supplier). Requires contact:read. Parseo: GET /contacts/{id}.

Parameterscontact_idrequired

parseo_list_audit_logs

List audit log

Query the team audit log: who did what, and when (for example invoice.created or api_key.rotated). Requires audit:read. Parseo: GET /audit-logs.

Parameterslimitactioncursorapi_key_idcreated_tocreated_fromresource_type

parseo_upload_invoice

Upload an invoice

Upload one invoice file (PDF, PNG, JPG or WebP, up to 7.5 MB) for OCR. It returns a job at once (HTTP 202); the invoice exists only after the job completes. Uses credits. Pass the same idempotency_key to retry safely. Requires invoice:write. Parseo: POST /invoices.

Parametersfilenamerequiredclient_iddirectionfile_base64requiredidempotency_keypartner_invoice_id

parseo_upload_invoices_batch

Upload several invoices

Upload up to 10 invoice files in one call (PDF, PNG, JPG or WebP, up to 7.5 MB each). Each result has its own jobId and status. Uses credits. Pass the same idempotency_key to retry safely. Requires invoice:write. Parseo: POST /invoices/batch.

Parametersfilesrequiredclient_ididempotency_key

parseo_update_invoice

Update an invoice

Correct the extracted fields of one invoice. Send only the fields to change; a changed exported invoice shows changedSinceExport. Requires invoice:write. Parseo: PATCH /invoices/{id}.

Parameterscurrencydue_datemetadatasubtotalclient_iddirectionamount_dueinvoice_idrequiredinvoice_datetotal_amountinvoice_numberinvoice_series+2 more

parseo_mark_invoice_exported

Mark an invoice as exported

Record that your system imported this invoice, so it leaves the export queue (exported=false). Repeat calls do not add exports. Use it only after your import succeeded. Requires invoice:export. Parseo: POST /invoices/{id}/exported.

Parametersclient_idinvoice_idrequiredexternal_reference

parseo_create_client

Create a client

Create a client (an end customer of your team). Use its id (cl_...) as client_id on invoice calls. Requires client:write. Parseo: POST /clients.

Parametersnamerequiredemailphoneaddressvat_numberdescriptioncompany_registration_number

parseo_update_client

Update a client

Change the details of one client. Send only the fields to change. Requires client:write. Parseo: PATCH /clients/{id}.

Parametersnameemailphoneaddressclient_idrequiredvat_numberdescriptioncompany_registration_number

parseo_create_contact

Create a contact

Create a buyer or supplier contact for one client. Requires contact:write. Parseo: POST /contacts.

Parametersnameemailphonevat_idaddressclient_idrequiredcompany_idparty_type

parseo_update_contact

Update a contact

Change the details of one contact. Send only the fields to change. Requires contact:write. Parseo: PATCH /contacts/{id}.

Parametersnameemailphonevat_idaddresscompany_idcontact_idrequiredparty_type

Version history

1
  1. v1.0.1LatestNov 7, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Ably MCP by usefulapi's hosted MCP server, published by usefulapi.io; no sign-in required; Streamable HTTP; 15 tools.

Streamable HTTPWeb executable
Communication & Collaboration15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026