income

Read and correct the income invoiced outside Melso, which the tax returns count with Melso’s own invoices. Monetary amounts are EUR decimal strings; update requires the saved expected_version. Each action accepts only its own fields (* required): list; get(id*); update(id*, expected_version*, customer_country, customer_name, customer_tax_id, description, document_number, file_id, irpf_amount, irpf_rate, issue_date, operation_date, vat_lines, vat_treatment); delete(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

{
  "additionalProperties": false,
  "properties": {
    "action": {
      "enum": [
        "list",
        "get",
        "update",
        "delete"
      ],
      "type": "string"
    },
    "customer_country": {
      "description": "Customer country as a two-letter code.",
      "type": "string"
    },
    "customer_name": {
      "description": "Customer name.",
      "type": "string"
    },
    "customer_tax_id": {
      "description": "Customer's tax ID.",
      "type": "string"
    },
    "description": {
      "description": "What was invoiced.",
      "type": "string"
    },
    "document_number": {
      "description": "The invoice's number.",
      "type": "string"
    },
    "expected_version": {
      "description": "Version from get/list. A stale version is refused.",
      "minimum": 1,
      "type": "integer"
    },
    "file_id": {
      "description": "Documents file UUID of the invoice, empty to unlink it.",
      "type": "string"
    },
    "id": {
      "description": "Company-scoped income UUID.",
      "type": "string"
    },
    "irpf_amount": {
      "description": "EUR IRPF the customer withheld as a decimal string.",
      "type": "string"
    },
    "irpf_rate": {
      "description": "IRPF the customer withheld as a percentage string.",
      "type": "string"
    },
    "issue_date": {
      "description": "Issue date YYYY-MM-DD; it places the income in a quarter.",
      "type": "string"
    },
    "operation_date": {
      "description": "Operation date YYYY-MM-DD when it differs, empty to clear.",
      "type": "string"
    },
    "vat_lines": {
      "description": "Every VAT rate's base and VAT; replaces the current lines.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "base": {
            "description": "EUR base as a decimal string.",
            "type": "string"
          },
          "rate": {
            "description": "VAT rate as a percentage string, 0 for a non-taxable line.",
            "type": "string"
          },
          "vat": {
            "description": "EUR VAT as a decimal string.",
            "type": "string"
          }
        },
        "required": [
          "rate",
          "base",
          "vat"
        ],
        "type": "object"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array"
    },
    "vat_treatment": {
      "description": "VAT treatment. Non-taxable lines carry rate 0 and no VAT.",
      "enum": [
        "taxable",
        "exempt",
        "reverse_charge",
        "not_subject"
      ],
      "type": "string"
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

Actions

The family schema combines fields for discovery. Each action accepts only its own fields below; add action when calling the family.

delete

Delete an income recorded by mistake, such as a duplicate, after the person confirms. Its file stays in Documents. Refused when a tax return covering its date was already approved or filed.

{
  "additionalProperties": false,
  "properties": {
    "id": {
      "description": "Company-scoped income UUID.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

get

Read one income with its VAT lines, withholding, review codes and saved version.

{
  "additionalProperties": false,
  "properties": {
    "id": {
      "description": "Company-scoped income UUID.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

list

List the income invoiced outside Melso (another invoicing tool, a platform, invoices from before Melso), with amounts, review codes and saved versions. Invoices issued with Melso are in invoices.

{
  "additionalProperties": false,
  "properties": {},
  "type": "object"
}

update

Correct only the supplied fields of an income at expected_version, for example what the document reading got wrong. Saving confirms it and clears its review codes. New income comes from from_document in expenses.

{
  "additionalProperties": false,
  "properties": {
    "customer_country": {
      "description": "Customer country as a two-letter code.",
      "type": "string"
    },
    "customer_name": {
      "description": "Customer name.",
      "type": "string"
    },
    "customer_tax_id": {
      "description": "Customer's tax ID.",
      "type": "string"
    },
    "description": {
      "description": "What was invoiced.",
      "type": "string"
    },
    "document_number": {
      "description": "The invoice's number.",
      "type": "string"
    },
    "expected_version": {
      "description": "Version from get/list. A stale version is refused.",
      "minimum": 1,
      "type": "integer"
    },
    "file_id": {
      "description": "Documents file UUID of the invoice, empty to unlink it.",
      "type": "string"
    },
    "id": {
      "description": "Company-scoped income UUID.",
      "type": "string"
    },
    "irpf_amount": {
      "description": "EUR IRPF the customer withheld as a decimal string.",
      "type": "string"
    },
    "irpf_rate": {
      "description": "IRPF the customer withheld as a percentage string.",
      "type": "string"
    },
    "issue_date": {
      "description": "Issue date YYYY-MM-DD; it places the income in a quarter.",
      "type": "string"
    },
    "operation_date": {
      "description": "Operation date YYYY-MM-DD when it differs, empty to clear.",
      "type": "string"
    },
    "vat_lines": {
      "description": "Every VAT rate's base and VAT; replaces the current lines.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "base": {
            "description": "EUR base as a decimal string.",
            "type": "string"
          },
          "rate": {
            "description": "VAT rate as a percentage string, 0 for a non-taxable line.",
            "type": "string"
          },
          "vat": {
            "description": "EUR VAT as a decimal string.",
            "type": "string"
          }
        },
        "required": [
          "rate",
          "base",
          "vat"
        ],
        "type": "object"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array"
    },
    "vat_treatment": {
      "description": "VAT treatment. Non-taxable lines carry rate 0 and no VAT.",
      "enum": [
        "taxable",
        "exempt",
        "reverse_charge",
        "not_subject"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "expected_version"
  ],
  "type": "object"
}

Output

Income records or the result of the selected update or deletion. Read identifiers from the company’s current records. 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.

curl --fail-with-body https://melso.ai/api/mcp \
  -H "Authorization: Bearer $MELSO_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data-binary @- <<'JSON'
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "income",
    "arguments": {
      "action": "list"
    }
  }
}
JSON

Connect

Contracts and access

Core tools

Agents and managed-Run tools

Advanced tools

Input

Autónomo / Company schema

Actions

Output

Example

​Input

​Autónomo / Company schema

​Actions

​Output

​Example

Input

Autónomo / Company schema

Actions

Output

Example