Consultar el perfil fiscal — fiscal_profile_read MCP

Read-only actions. Read and fill the company’s fiscal profile and its setup details. Requires the company’s owner or an admin. Updating fields does not calculate, approve or file taxes. set_registration saves whether an autónomo is already registered (alta); submit_setup sends the alta de autónomo they asked Melso for to Melso’s gestores as one support ticket. A company has neither: its activity is always empresarial and it has no IRPF method or withholding. Each action accepts only its own fields (* required): get. 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 fiscal_profile_read for get. Use fiscal_profile for the companion actions. The live tool list determines availability.

Input

{
  "additionalProperties": false,
  "oneOf": [
    {
      "additionalProperties": false,
      "properties": {
        "action": {
          "const": "get"
        }
      },
      "required": [
        "action"
      ],
      "type": "object"
    }
  ],
  "properties": {
    "action": {
      "enum": [
        "get"
      ],
      "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.

get

Read the company’s fiscal profile: what is saved, which required fields are still missing, and the onboarding state. Requires the company’s owner, admin or authorized gestor.

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

Output

get returns the saved fiscal profile, missing required fields and onboarding state. Only the company’s owner or an admin can use it. 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.

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.

Read the profile and what is missing

{
  "action": "get"
}

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": "fiscal_profile_read",
    "arguments": {
      "action": "get"
    }
  }
}
JSON

Connect

Clients

Use

Reference

Tools

Consultar el perfil fiscal — fiscal_profile_read MCP

When to use

Input

Actions

Read actions

Output

Example

​When to use

​Input

​Actions

​Read actions

​Output

​Example

When to use

Input

Actions

Read actions

Output

Example