> ## Documentation Index
> Fetch the complete documentation index at: https://docs.melso.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Melso product MCP: https://melso.ai/api/mcp (OAuth; one company per grant). REST: https://melso.ai. Documentation-search MCP: https://docs.melso.ai/mcp. The docs search server does not act on customer accounts.
>
> Use the live tool schema and respect company membership. Ask the person to authorize the exact fiscal document version in the signed-in app. A professional prepares and files included returns after authorization; AI does not file alone. A prepared file or approval receipt is not evidence of filing. Never claim completion from an accepted Task or Run. Keep credentials out of chat and logs. Agents features are internal or by private invitation.

# Tool catalog

> Listed and searchable tools for fiscal procedures and permitted integrations.

Use Melso MCP for procedures with Hacienda: query records, register expenses, prepare invoices and read the fiscal calendar. Exact fiscal approval stays in the signed-in app; Melso professionals handle included filing. No customer MCP tool approves, files or pays.

`tools/list` returns the core tools available to your connection. Advanced tools are **not returned by `tools/list`**: discover them through `tools_search`, then invoke the exact returned name through `tools_call`.

<Info>Melso Agents is available only internally or by private invitation. Agents-specific features require existing access. For the autónomo fiscal service, see [Get started](/essentials/quickstart).</Info>

The availability column shows server eligibility after company setup, derived from the same profiles and actor permissions as each tool page. Eligible autónomo and empresa connections include shared tools such as Library, Artifacts, Skills and Secrets alongside fiscal tools; these do not require an Agents invitation just because they are non-fiscal. **Autónomo** and **Empresa** identify eligible company types, not new signup offers. **Agents invitation** requires existing private access. **Managed Runs only** and **Managed Runs and Melso conversations** exclude external OAuth clients, including invited Agents users. **OAuth-only** excludes Run tokens. Membership, plan, connected services and action permissions can narrow any row. Shared tools have several audience labels. Rows marked only **Agents invitation** describe the private product and are not part of the autónomo service.

Autónomo and empresa Automations use the company's default execution. They can edit the allowed Automation fields, but cannot choose a harness or model through `automations_update_execution`; that operation requires Agents access.

## Core tools

**Call these tools directly.** To reach an advanced tool, use `tools_search`, then `tools_call`; see [Discover before calling](/mcp/results#discover-before-calling).

| Tool | Availability | Contract |
| - | - | - |
| `connected_apps_connect` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/connected-apps-connect) |
| `customers` | Autónomo / Empresa | [Inputs, output and example](/mcp/tools/customers) |
| `expenses` | Autónomo / Empresa | [Inputs, output and example](/mcp/tools/expenses) |
| `fiscal_profile` | Autónomo / Empresa / OAuth-only | [Inputs, output and example](/mcp/tools/fiscal-profile) |
| `income` | Autónomo / Empresa | [Inputs, output and example](/mcp/tools/income) |
| `invoices` | Autónomo / Empresa | [Inputs, output and example](/mcp/tools/invoices) |
| `knowledge_get` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/knowledge-get) |
| `knowledge_search` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/knowledge-search) |
| `knowledge_write` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/knowledge-write) |
| `memories` | Autónomo / Empresa / Agents invitation / OAuth-only | [Inputs, output and example](/mcp/tools/memories) |
| `payments` | Autónomo / Empresa | [Inputs, output and example](/mcp/tools/payments) |
| `secrets` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/secrets) |
| `skills` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/skills) |
| `support_tickets_create` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/support-tickets-create) |
| `tasks_control` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/tasks-control) |
| `tasks_create` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/tasks-create) |
| `tasks_get` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/tasks-get) |
| `tasks_list` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/tasks-list) |
| `tasks_send` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/tasks-send) |
| `tasks_update` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/tasks-update) |
| `tasks_wait` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/tasks-wait) |
| `taxes` | Autónomo / Empresa | [Inputs, output and example](/mcp/tools/taxes) |
| `tools_call` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/tools-call); [discovery rule](/mcp/results#discover-before-calling) |
| `tools_search` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/tools-search) |
| `workspace_status` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/workspace-status) |

## Agents and managed-Run tools

These tools can appear in `tools/list` only for an eligible private or managed connection.

| Tool | Availability | Contract |
| - | - | - |
| `areas` | Agents invitation | [Inputs, output and example](/mcp/tools/areas) |
| `ask_user` | Managed Runs only; external OAuth excluded | [Inputs, output and example](/mcp/tools/ask-user) |
| `request_approval` | Managed Runs only; external OAuth excluded | [Inputs, output and example](/mcp/tools/request-approval) |
| `tasks_watch` | Managed Runs and Melso conversations; external OAuth excluded | [Inputs, output and example](/mcp/tools/tasks-watch) |

## Advanced tools

**Discover with `tools_search`, then invoke the exact returned name through `tools_call`.** These names are not returned by `tools/list` and cannot be called directly.

| Tool | Availability | Contract |
| - | - | - |
| `artifacts_deploy` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/artifacts-deploy) |
| `artifacts_get` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/artifacts-get) |
| `artifacts_list` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/artifacts-list) |
| `artifacts_manage` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/artifacts-manage) |
| `automations_create` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/automations-create) |
| `automations_delete` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/automations-delete) |
| `automations_get` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/automations-get) |
| `automations_list` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/automations-list) |
| `automations_set_status` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/automations-set-status) |
| `automations_subscription_set` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/automations-subscription-set) |
| `automations_triggers_create` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/automations-triggers-create) |
| `automations_triggers_delete` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/automations-triggers-delete) |
| `automations_triggers_update` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/automations-triggers-update) |
| `automations_update` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/automations-update) |
| `automations_update_execution` | Agents invitation | [Inputs, output and example](/mcp/tools/automations-update-execution) |
| `company_update` | Agents invitation / OAuth-only | [Inputs, output and example](/mcp/tools/company-update) |
| `connected_apps_result` | Autónomo / Empresa / Agents invitation / OAuth-only | [Inputs, output and example](/mcp/tools/connected-apps-result) |
| `github_connect` | Agents invitation / OAuth-only | [Inputs, output and example](/mcp/tools/github-connect) |
| `github_installations_list` | Agents invitation / OAuth-only | [Inputs, output and example](/mcp/tools/github-installations-list) |
| `github_repositories_list` | Agents invitation / OAuth-only | [Inputs, output and example](/mcp/tools/github-repositories-list) |
| `knowledge_archive` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/knowledge-archive) |
| `knowledge_delete` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/knowledge-delete) |
| `knowledge_files` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/knowledge-files) |
| `knowledge_history` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/knowledge-history) |
| `knowledge_schema` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/knowledge-schema) |
| `knowledge_view` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/knowledge-view) |
| `profile_update` | Agents invitation / OAuth-only | [Inputs, output and example](/mcp/tools/profile-update) |
| `secrets_set` | Autónomo / Empresa / Agents invitation / OAuth-only | [Inputs, output and example](/mcp/tools/secrets-set) |
| `skills_save` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/skills-save) |
| `socials_accounts_list` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/socials-accounts-list) |
| `socials_call` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/socials-call) |
| `socials_tools_search` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/socials-tools-search) |
| `support_tickets_list` | Autónomo / Empresa / Agents invitation | [Inputs, output and example](/mcp/tools/support-tickets-list) |

## Connected app tools

Connected apps add a runtime catalog. Their names and schemas depend on the authenticated account and can change independently of Melso. Discover them with `tools_search`, then use the exact returned name and schema with `tools_call`. Never construct an app tool name or reuse a schema from a different connection.

## Combined status sections

`workspace_status` combines these source operations into one read. Request sections with `include`; their availability still follows the connection. These are section mappings, not extra tools to invent in a client.

| Source operation | Section |
| - | - |
| `company_get` | `company` |
| `usage_status` | `usage` |
| `execution_options` | `execution` |
| `connected_apps_list` | `connected_apps` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.