Consultar gestiones de alta y SL — gestiones_read MCP

Read-only actions. Open and follow this company’s cases with Melso’s professionals: tax forms (modelo); for an autónomo, self-employed registration (alta) and annual income tax (renta); incorporating an S.L.; and any other kind that kinds lists with its details schema and price. Save drafts, send covered cases, exchange messages and documents, answer information requests and request changes. get includes the conversation, versions, request and documents, and for a case sold once what Melso paid on the customer’s behalf and its invoice. Approving a version and paying a case sold once stay with the owner in the web app; no action files a return or pays. Monetary amounts are EUR decimal strings unless named in cents. Each action accepts only its own fields (* required): list; get(id*); kinds; request_approval(id*); document_get(id*, attachment_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 gestiones_read for document_get, get, kinds, list, request_approval. Use gestiones for the companion actions. The live tool list determines availability.

Input

{
  "additionalProperties": false,
  "oneOf": [
    {
      "additionalProperties": false,
      "properties": {
        "action": {
          "const": "list"
        }
      },
      "required": [
        "action"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "action": {
          "const": "get"
        },
        "id": {
          "description": "Case UUID from list or get, belonging to this company.",
          "type": "string"
        }
      },
      "required": [
        "action",
        "id"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "action": {
          "const": "kinds"
        }
      },
      "required": [
        "action"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "action": {
          "const": "request_approval"
        },
        "id": {
          "description": "Case UUID from list or get, belonging to this company.",
          "type": "string"
        }
      },
      "required": [
        "action",
        "id"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "action": {
          "const": "document_get"
        },
        "attachment_id": {
          "description": "Attachment UUID in the case's documents or versions from get.",
          "type": "string"
        },
        "id": {
          "description": "Case UUID from list or get, belonging to this company.",
          "type": "string"
        }
      },
      "required": [
        "action",
        "id",
        "attachment_id"
      ],
      "type": "object"
    }
  ],
  "properties": {
    "action": {
      "enum": [
        "list",
        "get",
        "kinds",
        "request_approval",
        "document_get"
      ],
      "type": "string"
    },
    "attachment_id": {
      "description": "Attachment UUID in the case's documents or versions from get.",
      "type": "string"
    },
    "id": {
      "description": "Case UUID from list or get, belonging to this company.",
      "type": "string"
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

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.

document_get

Read a document linked to this case, including a professional draft or receipt, as content_base64 with filename and content_type. Decode the bytes unchanged. At most 15 MB; larger documents are read in the authenticated web app.

{
  "additionalProperties": false,
  "properties": {
    "attachment_id": {
      "description": "Attachment UUID in the case's documents or versions from get.",
      "type": "string"
    },
    "id": {
      "description": "Case UUID from list or get, belonging to this company.",
      "type": "string"
    }
  },
  "required": [
    "id",
    "attachment_id"
  ],
  "type": "object"
}

get

Read one case with its conversation, versions, pending information request and documents, including drafts and filing receipts.

{
  "additionalProperties": false,
  "properties": {
    "id": {
      "description": "Case UUID from list or get, belonging to this company.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

kinds

List the kinds of case this company can open: what each is, its details_schema (JSON Schema for create), whether a member of the company approves a draft, and how it is paid: payment.mode plan (included when payment.covered) or service (a one-off price, payment.amount_cents in EUR cents, paid by the owner in the web app before it is sent).

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

list

List the company’s cases, newest first, with status, kind, deadlines, current and approved versions, filing reference and tax-service coverage.

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

request_approval

Return the current case version and authenticated web page where a member of the company reviews and approves it. Share approval_url. No MCP action approves, files or pays a return.

{
  "additionalProperties": false,
  "properties": {
    "id": {
      "description": "Case UUID from list or get, belonging to this company.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

Output

list returns cases and their status. get returns a case with its conversation, versions, information requests and documents. kinds returns available kinds and their details schemas. request_approval returns the current version and the owner’s approval link. document_get returns the file as base64. No action approves or files a case. 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

{
  "anyOf": [
    {
      "properties": {
        "gestiones": {
          "items": {
            "properties": {
              "current_version": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "filing_reference": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "id": {
                "type": "string"
              },
              "kind": {
                "type": "string"
              },
              "status": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    {
      "properties": {
        "documents": {
          "items": {
            "properties": {},
            "type": "object"
          },
          "type": "array"
        },
        "gestion": {
          "properties": {
            "current_version": {
              "type": [
                "integer",
                "null"
              ]
            },
            "filing_reference": {
              "type": [
                "string",
                "null"
              ]
            },
            "id": {
              "type": "string"
            },
            "kind": {
              "type": "string"
            },
            "status": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "request": {
          "type": [
            "object",
            "null"
          ]
        },
        "versions": {
          "items": {
            "properties": {},
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": [
        "gestion"
      ],
      "type": "object"
    },
    {
      "properties": {
        "kinds": {
          "items": {
            "properties": {},
            "type": "object"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    {
      "properties": {
        "approval_required": {
          "type": "boolean"
        },
        "approval_url": {
          "type": "string"
        },
        "is_preview": {
          "type": "boolean"
        },
        "version": {
          "type": "integer"
        }
      },
      "type": "object"
    },
    {
      "properties": {
        "content_base64": {
          "type": "string"
        },
        "content_type": {
          "type": "string"
        },
        "filename": {
          "type": "string"
        }
      },
      "required": [
        "filename",
        "content_type",
        "content_base64"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}

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.

See what the company can ask for

{
  "action": "kinds"
}

Read the case and any question it has

{
  "action": "get",
  "id": "11111111-1111-4111-8111-111111111111"
}

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.

curl --fail-with-body https://mcp.melso.ai/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": "gestiones_read",
    "arguments": {
      "action": "kinds"
    }
  }
}
JSON

Connect

Clients

Use

Reference

Tools

Consultar gestiones de alta y SL — gestiones_read MCP

When to use

Input

Actions

Read actions

Output

Declared output schema

Example

​When to use

​Input

​Actions

​Read actions

​Output

​Declared output schema

​Example

When to use

Input

Actions

Read actions

Output

Declared output schema

Example