Parseo MCP by usefulapi is an MCP server published by io.usefulapi, hosted at parseo.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 23 tools, including parseo_get_key_info, parseo_get_credit_balance, parseo_get_quota, parseo_get_usage, parseo_list_invoices.
Upload invoices for OCR; read, export and correct extracted invoices in Parseo.
3,962 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
No parameters.
{
"name": "parseo_get_key_info",
"title": "Get API key info",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get API key info",
"readOnlyHint": true
}
}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.
No parameters.
{
"name": "parseo_get_credit_balance",
"title": "Get credit balance",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get credit balance",
"readOnlyHint": true
}
}Show credits, plan limits and current usage in one reply. Parseo: GET /me/quota.
No parameters.
{
"name": "parseo_get_quota",
"title": "Get quota snapshot",
"description": "Show credits, plan limits and current usage in one reply. Parseo: GET /me/quota.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get quota snapshot",
"readOnlyHint": true
}
}Show invoice usage per day for the last N days (1-90). Parseo: GET /usage.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Trailing days to aggregate (1-90). |
{
"name": "parseo_get_usage",
"title": "Get usage metrics",
"description": "Show invoice usage per day for the last N days (1-90). Parseo: GET /usage.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"days": {
"type": "integer",
"maximum": 90,
"minimum": 1,
"description": "Trailing days to aggregate (1-90)."
}
}
},
"annotations": {
"title": "Get usage metrics",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| sort | string | Sort order. |
| limit | integer | Items per page (1-200). |
| cursor | string | Cursor from the previous page (pagination.nextCursor). |
| expand | string | 'seller', 'buyer' or 'seller,buyer': replace contact ids with contact objects. |
| status | string | Processing status. |
| currency | string | ISO 4217 code, for example EUR. |
| exported | boolean | false = invoices nobody has exported yet (an import queue). |
| client_id | string | Client id (cl_...) for a team-wide key. Omit it to use the client set at login. |
| direction | string | purchase = incoming bill, sale = outgoing invoice. |
| total_max | number | Total amount at or below this value. |
| total_min |
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}.
| Parameter | Type | Description |
|---|---|---|
| expand | string | 'seller', 'buyer' or 'seller,buyer': replace contact ids with contact objects. |
| fields | string | Comma-separated top-level fields to return, for example id,status,totalAmount. |
| client_id | string | Client id (cl_...) for a team-wide key. Omit it to use the client set at login. |
| invoice_id * | string | Invoice id (inv_...), from the job or the list. |
{
"name": "parseo_get_invoice",
"title": "Get an invoice",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice_id"
],
"properties": {
"expand": {
"type": "string",
"maxLength": 20,
"description": "'seller', 'buyer' or 'seller,buyer': replace contact ids with contact objects."
},
"fields": {
"type": "string",
"maxLength": 500,
"description": "Comma-separated top-level fields to return, for example id,status,totalAmount."
},
"client_id": {
"type": "string",
"description": "Client id (cl_...) for a team-wide key. Omit it to use the client set at login."
},
"invoice_id": {
"type": "string",
"pattern": "^inv_[A-Za-z0-9_-]{1,80}$",
"description": "Invoice id (inv_...), from the job or the list."
}
}
},
"annotations": {
"title": "Get an invoice",
"readOnlyHint": true
}
}Get the processing status of one invoice (queued, processing, processed or failed). Requires invoice:read. Parseo: GET /invoices/{id}/status.
| Parameter | Type | Description |
|---|---|---|
| client_id | string | Client id (cl_...) for a team-wide key. Omit it to use the client set at login. |
| invoice_id * | string | Invoice id (inv_...). |
{
"name": "parseo_get_invoice_status",
"title": "Get invoice status",
"description": "Get the processing status of one invoice (queued, processing, processed or failed). Requires invoice:read. Parseo: GET /invoices/{id}/status.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice_id"
],
"properties": {
"client_id": {
"type": "string",
"description": "Client id (cl_...) for a team-wide key. Omit it to use the client set at login."
},
"invoice_id": {
"type": "string",
"pattern": "^inv_[A-Za-z0-9_-]{1,80}$",
"description": "Invoice id (inv_...)."
}
}
},
"annotations": {
"title": "Get invoice status",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| format | string | Export format. Default json. |
| client_id | string | Client id (cl_...) for a team-wide key. Omit it to use the client set at login. |
| invoice_id * | string | Invoice id (inv_...). |
{
"name": "parseo_export_invoice",
"title": "Export an invoice",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice_id"
],
"properties": {
"format": {
"enum": [
"json",
"xml",
"rivile",
"finvalda",
"centas",
"agnum",
"pragma_4",
"b1",
"directo",
"odoo",
"optimum"
],
"type": "string",
"description": "Export format. Default json."
},
"client_id": {
"type": "string",
"description": "Client id (cl_...) for a team-wide key. Omit it to use the client set at login."
},
"invoice_id": {
"type": "string",
"pattern": "^inv_[A-Za-z0-9_-]{1,80}$",
"description": "Invoice id (inv_...)."
}
}
},
"annotations": {
"title": "Export an invoice",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page (1-100). |
| cursor | string | Cursor from the previous page (pagination.nextCursor). |
| status | string | one of ["processing","awaiting_credits","completed","failed"] |
| client_id | string | Only jobs of this client (cl_... id). |
| created_to | string | ISO 8601 timestamp, for example 2026-10-01T00:00:00Z. |
| created_from | string | ISO 8601 timestamp, for example 2026-10-01T00:00:00Z. |
{
"name": "parseo_list_jobs",
"title": "List ingestion jobs",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page (1-100)."
},
"cursor": {
"type": "string",
"maxLength": 2000,
"description": "Cursor from the previous page (pagination.nextCursor)."
},
"status": {
"enum": [
"processing",
"awaiting_credits",
"completed",
"failed"
],
"type": "string"
},
"client_id": {
"type": "string",
"maxLength": 100,
"description": "Only jobs of this client (cl_... id)."
},
"created_to": {
"type": "string",
"maxLength": 40,
"minLength": 10,
"description": "ISO 8601 timestamp, for example 2026-10-01T00:00:00Z."
},
"created_from": {
"type": "string",
"maxLength": 40,
"minLength": 10,
"description": "ISO 8601 timestamp, for example 2026-10-01T00:00:00Z."
}
}
},
"annotations": {
"title": "List ingestion jobs",
"readOnlyHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | Job id (job_...), from the upload reply. |
{
"name": "parseo_get_job",
"title": "Get an ingestion job",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^job_[A-Za-z0-9_-]{1,80}$",
"description": "Job id (job_...), from the upload reply."
}
}
},
"annotations": {
"title": "Get an ingestion job",
"readOnlyHint": true
}
}List the clients (end customers) of the team. Each client has an id (cl_...) for X-Client-Id. Requires client:read. Parseo: GET /clients.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page (1-200). |
| cursor | string | Cursor from the previous page (pagination.nextCursor). |
{
"name": "parseo_list_clients",
"title": "List clients",
"description": "List the clients (end customers) of the team. Each client has an id (cl_...) for X-Client-Id. Requires client:read. Parseo: GET /clients.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Items per page (1-200)."
},
"cursor": {
"type": "string",
"maxLength": 2000,
"description": "Cursor from the previous page (pagination.nextCursor)."
}
}
},
"annotations": {
"title": "List clients",
"readOnlyHint": true
}
}Get one client with its company details. Requires client:read. Parseo: GET /clients/{id}.
| Parameter | Type | Description |
|---|---|---|
| client_id * | string | Client id (cl_...). |
{
"name": "parseo_get_client",
"title": "Get a client",
"description": "Get one client with its company details. Requires client:read. Parseo: GET /clients/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "string",
"pattern": "^cl_[A-Za-z0-9_-]{1,80}$",
"description": "Client id (cl_...)."
}
}
},
"annotations": {
"title": "Get a client",
"readOnlyHint": true
}
}List buyer and supplier contacts, optionally for one client. Requires contact:read. Parseo: GET /contacts.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page (1-200). |
| cursor | string | Cursor from the previous page (pagination.nextCursor). |
| client_id | string | Only contacts of this client (cl_... id). |
{
"name": "parseo_list_contacts",
"title": "List contacts",
"description": "List buyer and supplier contacts, optionally for one client. Requires contact:read. Parseo: GET /contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Items per page (1-200)."
},
"cursor": {
"type": "string",
"maxLength": 2000,
"description": "Cursor from the previous page (pagination.nextCursor)."
},
"client_id": {
"type": "string",
"maxLength": 100,
"description": "Only contacts of this client (cl_... id)."
}
}
},
"annotations": {
"title": "List contacts",
"readOnlyHint": true
}
}Get one contact (buyer or supplier). Requires contact:read. Parseo: GET /contacts/{id}.
| Parameter | Type | Description |
|---|---|---|
| contact_id * | string | Contact id (con_...). |
{
"name": "parseo_get_contact",
"title": "Get a contact",
"description": "Get one contact (buyer or supplier). Requires contact:read. Parseo: GET /contacts/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact_id"
],
"properties": {
"contact_id": {
"type": "string",
"pattern": "^con_[A-Za-z0-9_-]{1,80}$",
"description": "Contact id (con_...)."
}
}
},
"annotations": {
"title": "Get a contact",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page (1-200). |
| action | string | Exact action name, for example invoice.created. |
| cursor | string | Cursor from the previous page (pagination.nextCursor). |
| api_key_id | string | Only actions of this API key (ak_... id). |
| created_to | string | ISO 8601 timestamp, for example 2026-10-01T00:00:00Z. |
| created_from | string | ISO 8601 timestamp, for example 2026-10-01T00:00:00Z. |
| resource_type | string | one of ["invoice","contact","api-key","webhook","client"] |
{
"name": "parseo_list_audit_logs",
"title": "List audit log",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Items per page (1-200)."
},
"action": {
"type": "string",
"maxLength": 100,
"description": "Exact action name, for example invoice.created."
},
"cursor": {
"type": "string",
"maxLength": 2000,
"description": "Cursor from the previous page (pagination.nextCursor)."
},
"api_key_id": {
"type": "string",
"maxLength": 100,
"description": "Only actions of this API key (ak_... id)."
},
"created_to": {
"type": "string",
"maxLength": 40,
"minLength": 10,
"description": "ISO 8601 timestamp, for example 2026-10-01T00:00:00Z."
},
"created_from": {
"type": "string",
"maxLength": 40,
"minLength": 10,
"description": "ISO 8601 timestamp, for example 2026-10-01T00:00:00Z."
},
"resource_type": {
"enum": [
"invoice",
"contact",
"api-key",
"webhook",
"client"
],
"type": "string"
}
}
},
"annotations": {
"title": "List audit log",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| filename * | string | |
| client_id | string | Client id (cl_...) for a team-wide key. Omit it to use the client set at login. |
| direction | string | purchase = incoming bill, sale = outgoing invoice. Leave it out to use Parseo's default. |
| file_base64 * | string | The file's bytes, base64-encoded. |
| idempotency_key | string | Retry key: send the same key on a retry of the same upload. Parseo keeps the first result for 24 hours. |
| partner_invoice_id | string | Your own id for this invoice, stored in metadata.partnerInvoiceId. |
{
"name": "parseo_upload_invoice",
"title": "Upload an invoice",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"filename",
"file_base64"
],
"properties": {
"filename": {
"type": "string",
"pattern": "^[^/\\\\\\x00-\\x1f]+$",
"maxLength": 200,
"minLength": 1
},
"client_id": {
"type": "string",
"description": "Client id (cl_...) for a team-wide key. Omit it to use the client set at login."
},
"direction": {
"enum": [
"purchase",
"sale"
],
"type": "string",
"description": "purchase = incoming bill, sale = outgoing invoice. Leave it out to use Parseo's default."
},
"file_base64": {
"type": "string",
"maxLength": 10000000,
"minLength": 4,
"description": "The file's bytes, base64-encoded."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,200}$",
"description": "Retry key: send the same key on a retry of the same upload. Parseo keeps the first result for 24 hours."
},
"partner_invoice_id": {
"type": "string",
"maxLength": 200,
"description": "Your own id for this invoice, stored in metadata.partnerInvoiceId."
}
}
},
"annotations": {
"title": "Upload an invoice",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| files * | array | 1-10 files. |
| client_id | string | Client id (cl_...) for a team-wide key. Omit it to use the client set at login. |
| idempotency_key | string | Retry key: send the same key on a retry of the same upload. Parseo keeps the first result for 24 hours. |
{
"name": "parseo_upload_invoices_batch",
"title": "Upload several invoices",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"files"
],
"properties": {
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"filename",
"file_base64"
],
"properties": {
"filename": {
"type": "string",
"pattern": "^[^/\\\\\\x00-\\x1f]+$",
"maxLength": 200,
"minLength": 1
},
"file_base64": {
"type": "string",
"maxLength": 10000000,
"minLength": 4,
"description": "The file's bytes, base64-encoded."
}
}
},
"maxItems": 10,
"minItems": 1,
"description": "1-10 files."
},
"client_id": {
"type": "string",
"description": "Client id (cl_...) for a team-wide key. Omit it to use the client set at login."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,200}$",
"description": "Retry key: send the same key on a retry of the same upload. Parseo keeps the first result for 24 hours."
}
}
},
"annotations": {
"title": "Upload several invoices",
"destructiveHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| currency | string | ISO 4217 code, for example EUR. |
| due_date | string | |
| metadata | object | Your own key-value data, stored with the invoice. |
| subtotal | number | |
| client_id | string | Client id (cl_...) for a team-wide key. Omit it to use the client set at login. |
| direction | string | one of ["purchase","sale"] |
| amount_due | number | |
| invoice_id * | string | Invoice id (inv_...). |
| invoice_date | string | |
| total_amount | number | |
| invoice_number | string |
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.
| Parameter | Type | Description |
|---|---|---|
| client_id | string | Client id (cl_...) for a team-wide key. Omit it to use the client set at login. |
| invoice_id * | string | Invoice id (inv_...). |
| external_reference | string | Your own id for the imported document, for example ERP-2026-00412. |
{
"name": "parseo_mark_invoice_exported",
"title": "Mark an invoice as exported",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice_id"
],
"properties": {
"client_id": {
"type": "string",
"description": "Client id (cl_...) for a team-wide key. Omit it to use the client set at login."
},
"invoice_id": {
"type": "string",
"pattern": "^inv_[A-Za-z0-9_-]{1,80}$",
"description": "Invoice id (inv_...)."
},
"external_reference": {
"type": "string",
"maxLength": 200,
"description": "Your own id for the imported document, for example ERP-2026-00412."
}
}
},
"annotations": {
"title": "Mark an invoice as exported",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Client name. |
| string | ||
| phone | string | |
| address | string | |
| vat_number | string | |
| description | string | |
| company_registration_number | string |
{
"name": "parseo_create_client",
"title": "Create a client",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Client name."
},
"email": {
"type": "string",
"maxLength": 200
},
"phone": {
"type": "string",
"maxLength": 100
},
"address": {
"type": "string",
"maxLength": 500
},
"vat_number": {
"type": "string",
"maxLength": 100
},
"description": {
"type": "string",
"maxLength": 1000
},
"company_registration_number": {
"type": "string",
"maxLength": 100
}
}
},
"annotations": {
"title": "Create a client",
"destructiveHint": true
}
}Change the details of one client. Send only the fields to change. Requires client:write. Parseo: PATCH /clients/{id}.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| string | ||
| phone | string | |
| address | string | |
| client_id * | string | Client id (cl_...). |
| vat_number | string | |
| description | string | |
| company_registration_number | string |
{
"name": "parseo_update_client",
"title": "Update a client",
"description": "Change the details of one client. Send only the fields to change. Requires client:write. Parseo: PATCH /clients/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"email": {
"type": "string",
"maxLength": 200
},
"phone": {
"type": "string",
"maxLength": 100
},
"address": {
"type": "string",
"maxLength": 500
},
"client_id": {
"type": "string",
"pattern": "^cl_[A-Za-z0-9_-]{1,80}$",
"description": "Client id (cl_...)."
},
"vat_number": {
"type": "string",
"maxLength": 100
},
"description": {
"type": "string",
"maxLength": 1000
},
"company_registration_number": {
"type": "string",
"maxLength": 100
}
}
},
"annotations": {
"title": "Update a client",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Create a buyer or supplier contact for one client. Requires contact:write. Parseo: POST /contacts.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| string | ||
| phone | string | |
| vat_id | string | |
| address | string | |
| client_id * | string | The client this contact belongs to (cl_...). |
| company_id | string | Company registration id. |
| party_type | string | one of ["individual","company"] |
{
"name": "parseo_create_contact",
"title": "Create a contact",
"description": "Create a buyer or supplier contact for one client. Requires contact:write. Parseo: POST /contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"email": {
"type": "string",
"maxLength": 200
},
"phone": {
"type": "string",
"maxLength": 100
},
"vat_id": {
"type": "string",
"maxLength": 100
},
"address": {
"type": "string",
"maxLength": 500
},
"client_id": {
"type": "string",
"pattern": "^cl_[A-Za-z0-9_-]{1,80}$",
"description": "The client this contact belongs to (cl_...)."
},
"company_id": {
"type": "string",
"maxLength": 100,
"description": "Company registration id."
},
"party_type": {
"enum": [
"individual",
"company"
],
"type": "string"
}
}
},
"annotations": {
"title": "Create a contact",
"destructiveHint": true
}
}Change the details of one contact. Send only the fields to change. Requires contact:write. Parseo: PATCH /contacts/{id}.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| string | ||
| phone | string | |
| vat_id | string | |
| address | string | |
| company_id | string | Company registration id. |
| contact_id * | string | Contact id (con_...). |
| party_type | string | one of ["individual","company"] |
{
"name": "parseo_update_contact",
"title": "Update a contact",
"description": "Change the details of one contact. Send only the fields to change. Requires contact:write. Parseo: PATCH /contacts/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"email": {
"type": "string",
"maxLength": 200
},
"phone": {
"type": "string",
"maxLength": 100
},
"vat_id": {
"type": "string",
"maxLength": 100
},
"address": {
"type": "string",
"maxLength": 500
},
"company_id": {
"type": "string",
"maxLength": 100,
"description": "Company registration id."
},
"contact_id": {
"type": "string",
"pattern": "^con_[A-Za-z0-9_-]{1,80}$",
"description": "Contact id (con_...)."
},
"party_type": {
"enum": [
"individual",
"company"
],
"type": "string"
}
}
},
"annotations": {
"title": "Update a contact",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for Parseo, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Upload this invoice PDF and tell me when it is processed."; "List the invoices that are not exported yet, and show their totals."; "How many credits are left this month, and which uploads are waiting for credits?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Parseo data. Free plan: 50 tool calls per month. Run parseo_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run parseo_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run parseo_upgrade without a plan: it returns both plans, each with a payment link for the user to open. parseo_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| number |
| Total amount at or above this value. |
| buyer_name | string | Part of the buyer name (case-insensitive). |
| contact_id | string | Only invoices with this contact (con_...). |
| created_to | string | Created at or before this time. |
| seller_name | string | Part of the seller name (case-insensitive). |
| created_from | string | Created at or after this time. |
| invoice_number | string | Exact invoice number, or 'prefix:ABC' for a prefix match. |
| is_export_valid | boolean | true = only invoices that pass export validation. |
| changed_since_export | boolean | true = exported invoices corrected after their export. |
{
"name": "parseo_list_invoices",
"title": "List invoices",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"enum": [
"createdAt:asc",
"createdAt:desc",
"invoiceDate:asc",
"invoiceDate:desc",
"totalAmount:asc",
"totalAmount:desc"
],
"type": "string",
"description": "Sort order."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Items per page (1-200)."
},
"cursor": {
"type": "string",
"maxLength": 2000,
"description": "Cursor from the previous page (pagination.nextCursor)."
},
"expand": {
"type": "string",
"maxLength": 20,
"description": "'seller', 'buyer' or 'seller,buyer': replace contact ids with contact objects."
},
"status": {
"enum": [
"queued",
"awaiting_credits",
"processing",
"processed",
"failed"
],
"type": "string",
"description": "Processing status."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 code, for example EUR."
},
"exported": {
"type": "boolean",
"description": "false = invoices nobody has exported yet (an import queue)."
},
"client_id": {
"type": "string",
"description": "Client id (cl_...) for a team-wide key. Omit it to use the client set at login."
},
"direction": {
"enum": [
"purchase",
"sale"
],
"type": "string",
"description": "purchase = incoming bill, sale = outgoing invoice."
},
"total_max": {
"type": "number",
"description": "Total amount at or below this value."
},
"total_min": {
"type": "number",
"description": "Total amount at or above this value."
},
"buyer_name": {
"type": "string",
"maxLength": 200,
"description": "Part of the buyer name (case-insensitive)."
},
"contact_id": {
"type": "string",
"pattern": "^con_[A-Za-z0-9_-]{1,80}$",
"description": "Only invoices with this contact (con_...)."
},
"created_to": {
"type": "string",
"maxLength": 40,
"minLength": 10,
"description": "Created at or before this time."
},
"seller_name": {
"type": "string",
"maxLength": 200,
"description": "Part of the seller name (case-insensitive)."
},
"created_from": {
"type": "string",
"maxLength": 40,
"minLength": 10,
"description": "Created at or after this time."
},
"invoice_number": {
"type": "string",
"maxLength": 200,
"description": "Exact invoice number, or 'prefix:ABC' for a prefix match."
},
"is_export_valid": {
"type": "boolean",
"description": "true = only invoices that pass export validation."
},
"changed_since_export": {
"type": "boolean",
"description": "true = exported invoices corrected after their export."
}
}
},
"annotations": {
"title": "List invoices",
"readOnlyHint": true
}
}| invoice_series | string |
| buyer_contact_id | string |
| seller_contact_id | string |
{
"name": "parseo_update_invoice",
"title": "Update an invoice",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice_id"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 code, for example EUR."
},
"due_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"metadata": {
"type": "object",
"description": "Your own key-value data, stored with the invoice.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"subtotal": {
"type": "number"
},
"client_id": {
"type": "string",
"description": "Client id (cl_...) for a team-wide key. Omit it to use the client set at login."
},
"direction": {
"enum": [
"purchase",
"sale"
],
"type": "string"
},
"amount_due": {
"type": "number"
},
"invoice_id": {
"type": "string",
"pattern": "^inv_[A-Za-z0-9_-]{1,80}$",
"description": "Invoice id (inv_...)."
},
"invoice_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"total_amount": {
"type": "number"
},
"invoice_number": {
"type": "string",
"maxLength": 200
},
"invoice_series": {
"type": "string",
"maxLength": 100
},
"buyer_contact_id": {
"type": "string",
"pattern": "^con_[A-Za-z0-9_-]{1,80}$"
},
"seller_contact_id": {
"type": "string",
"pattern": "^con_[A-Za-z0-9_-]{1,80}$"
}
}
},
"annotations": {
"title": "Update an invoice",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}