Skip to main content
The company’s tax calendar and the returns Melso calculates (303, 130, 111, 115, 390 and the informative returns). Read and explain them; request_approval gives the authenticated web link where the owner authorizes the exact version for Melso’s professionals to review and file under the required authority. An unchanged authorized version proceeds; a changed draft needs new approval. Filing requires the actual external reference and receipt. An estimate (is_preview) has no approval link. No action approves, files or pays a return. Each action accepts only its own fields (* required): calendar; list; get(id*); request_approval(id*); aeat_file(id*). Availability: Autónomo / Empresa. Catalog: Core (tools/list). The live catalog is authoritative: company type, membership, plan, connected apps and execution context can narrow this contract. Understand access.

​
Input

​
Autónomo / Company schema

​
Actions

The family schema combines fields for discovery. Each action accepts only its own fields below; add action when calling the family.
The 303, 130, 111 or 115 import file as content_base64. Write the decoded bytes unchanged (ISO-8859-1) under filename. This is preparation, not authorization or proof of filing. Share approval_url so the owner authorizes the exact version in the web app for Melso’s professionals to review and file under the required authority; do not ask the owner or an agent to file the included return.
What the company files and when: each form due from its fiscal profile and records, with its deadline, the last day to pay by direct debit, whether Melso calculates it (filing_id links the return) or only reminds, and its status. Past deadlines appear while unfiled. The person marks a reminder filed at taxes_url.
One calculated return with its boxes, the lines of an informative return, review codes and whether an AEAT import file exists. Use it to explain a figure to the person. An estimate (is_preview) has only its amount.
The returns Melso calculated, newest first: model, period, status (draft, reviewed, approved, filed), amount (negative to compensate or refund), deadlines and what to check before filing. Drafts are recalculated from the records while their window is open. is_preview true marks an estimate (id preview:<model>:<period>) for a company without an active Pro or Plus tax service: no boxes, approval page or AEAT file.
Answer the authenticated web link where the owner reviews the exact calculated return and authorizes its version. This starts a case for Melso’s professionals to review and file with Hacienda under the required authority. An unchanged authorized version proceeds; a changed draft needs new approval. Filing is complete only with the actual external reference and receipt. Share approval_url; no agent tool approves, files or pays a return. An estimate (is_preview) has no approval page: it answers approval_required false and no link; say it is an estimate.

​
Output

Return records, calendar entries, an export, or the saved preview and human approval link. aeat_file produces an import file; it does not submit a return to the tax authority. 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. The server does not currently declare an outputSchema, so treat additional fields as extensible. Result handling.

​
Example

Use an OAuth access token issued for this MCP resource (a Run token for Run-only tools). Replace example identifiers with values from your own account. Write actions change data.