# Parseo Muse connector

From musedirectory.ai, the independent directory of Meta Muse connectors. Not affiliated with Meta.

## Parseo

Turn invoice photos and PDFs into clean, correctable data

- Record: https://musedirectory.ai/connector/parseo
- Category: Finance & Bills
- Developer: usefulapi (https://usefulapi.io/parseo/)
- Muse status: Extra setup. Not in Muse's Connectors list yet. Muse can still use it: its page gives you a request to paste into Muse.
- Health: Working, 156ms, checked 2026-11-08T03:45:50Z
- Endpoint: https://parseo.usefulapi.io/mcp
- Auth: No account needed; Pricing: unknown
- Screening: Screened, no issues found (2026-11-07T22:11:09Z)
- Source: Found in the official MCP Registry (io.usefulapi/parseo) https://registry.modelcontextprotocol.io/v0/servers?search=io.usefulapi%2Fparseo

Connects to Parseo's invoice OCR service. Muse can send invoices in for extraction, then read, export and fix the extracted line items and totals, which helps with bookkeeping and expense tracking.

Example request: "Upload this month's supplier invoices to Parseo and give me a list of totals and due dates."

How to connect: Not in Muse's Connectors list yet, but Muse can still use it. Paste this into Muse: "Use Parseo to help me. It is a free service with an MCP server at https://parseo.usefulapi.io/mcp. It does not need an API key. Ask me before you share anything with it." Muse asks before it shares anything with the app's site. Meta does not review apps used this way, so only use ones you trust. We tested this in the Muse app on September 24, 2026: Muse used an app's link directly this way and returned a live answer.

Tools:
- parseo_get_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.
- parseo_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.
- parseo_get_quota: Show credits, plan limits and current usage in one reply. Parseo: GET /me/quota.
- parseo_get_usage: Show invoice usage per day for the last N days (1-90). Parseo: GET /usage.
- parseo_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.
- parseo_get_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}.
- parseo_get_invoice_status: Get the processing status of one invoice (queued, processing, processed or failed). Requires invoice:read. Parseo: GET /invoices/{id}/status.
- parseo_export_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.
- parseo_list_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.
- parseo_get_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}.
- parseo_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.
- parseo_get_client: Get one client with its company details. Requires client:read. Parseo: GET /clients/{id}.
- parseo_list_contacts: List buyer and supplier contacts, optionally for one client. Requires contact:read. Parseo: GET /contacts.
- parseo_get_contact: Get one contact (buyer or supplier). Requires contact:read. Parseo: GET /contacts/{id}.
- parseo_list_audit_logs: 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.
- parseo_upload_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.
- parseo_upload_invoices_batch: 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.
- parseo_update_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}.
- parseo_mark_invoice_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.
- parseo_create_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.
- parseo_update_client: Change the details of one client. Send only the fields to change. Requires client:write. Parseo: PATCH /clients/{id}.
- parseo_create_contact: Create a buyer or supplier contact for one client. Requires contact:write. Parseo: POST /contacts.
- parseo_update_contact: Change the details of one contact. Send only the fields to change. Requires contact:write. Parseo: PATCH /contacts/{id}.

Screening checks:
- MCP handshake: pass (Answered in 181ms)
- Domain against threat feeds (Cloudflare security DNS): pass (parseo.usefulapi.io, usefulapi.io not flagged)
- Published packages against the OSV malicious-package database: n/a (No npm or PyPI package published)
- Hidden instructions or invisible characters in tool text: n/a (Tools are behind sign-in)
- Inputs asking for passwords, card numbers or seed phrases: n/a (Tools are behind sign-in)
- Domain and redirects: pass (No redirects off the domain)
- AI review of purpose and tool behavior: pass (No concerns)
