Skip to main content
Read-only actions. Read and record this company’s expenses, and read any invoice or receipt with from_document, which records it as an expense or an income. Monetary amounts are EUR decimal strings. vat_country is the VAT jurisdiction printed on the invoice, separately from supplier_country. Spanish VAT from a foreign supplier stays pending until Melso reviews invoice entitlement and vat_deductible is true. Ask customers only whether an undecided expense belongs to their professional activity; technical warnings are Melso’s responsibility. Save the answer with only id, expected_version and deductible, preserving internal review codes. Other edits retain fiscal evidence validation. Deductible is an activity classification, not approval of a deduction. category is the AEAT expense concept code; deductibility is Melso’s estimate (likely, review or unlikely) with the rule behind it, never a confirmed deduction. An expense in another currency counts at the ECB rate of its date; update records when it was paid and the euros that went out (paid_date, paid_amount), and the 130 counts the difference then. Each action accepts only its own fields (* required): list(contact_id, cursor, document_number, due_date_end, due_date_start, end_date, limit, q, sort, start_date, status); get(id*); document_status(job_id). Availability: Autónomo / Empresa. Access: Live in the Melso app and over MCP for a signed-in person. Where the partner REST API covers the same area, that path is private beta until Melso enables your account. See Access and pricing. The live tool list is authoritative: the company’s plan and your role can narrow this contract. Understand access.

​
When to use

Use expenses_read for document_status, get, list. Use expenses for the companion actions. The live tool list determines availability.

​
Input

​
Actions

The tool’s schema combines the fields of every action. Each action accepts only its own fields below; send action with them.

​
Read actions

These actions only read. They change nothing.
What documents queued with from_document became: one job by job_id, or the company’s latest twenty. Each says queued, done (with the expense or income recorded, its review codes and deductibility) or failed (with a code; direction_unknown means ask and queue it again with direction; country_unknown means ask the supplier/customer country and retry with counterparty_country and the direction from the error).
Read one expense belonging to this company, including its saved version, deductibility and review codes.
List bounded expense summaries with saved versions, category, classification and settlement balances. Get an expense for its full evidence, review codes and deductibility estimate. Follow next_cursor while has_more and keep filters unchanged.

​
Output

list and get return expenses with their amounts, category, review and saved version. document_status returns what a queued document became. The result uses MCP content blocks; JSON payloads are encoded in text and may also appear in structuredContent. Check isError before reading a success payload. When the server declares an outputSchema, it is reproduced below. Check the action result and its declared fields before reporting success.

​
Declared output schema

​
Example

Use the actions of this tool in the order shown; its companion tool covers the other actions. These are the arguments of each call, in order.
1

See what the document became

The first call as a request. Use an OAuth access token issued for this MCP resource and replace the example identifiers with values from your own company.