> ## 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.

# Melso API

> Build integrations with Tasks, Runs, company resources and signed webhooks.

<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>

## Base URL

Set `MELSO_URL=https://melso.ai`, with no trailing slash or `/api` suffix. Append each complete route to that origin: `GET /api/me` becomes `$MELSO_URL/api/me`. OAuth and metadata routes use the same origin with their own paths, such as `$MELSO_URL/.well-known/oauth-authorization-server`.

List responses have no universal envelope. Check the operation schema and [Pagination](/api-reference/pagination) for the list you need.

<CardGroup cols={2}>
  <Card title="Send your first request" icon="terminal" href="/api-reference/quickstart">Make a read-only call, then confirm funding before starting work.</Card>
  <Card title="Choose a credential" icon="key" href="/api-reference/authentication">Company keys, personal tokens, Run tokens and MCP OAuth have different authority.</Card>
  <Card title="Receive events" icon="bell" href="/api-reference/webhooks">Verify signatures and process deliveries safely.</Card>
  <Card title="Use MCP" icon="plug" href="/mcp/connect">Query fiscal records, register expenses and prepare invoices with explicit consent.</Card>
</CardGroup>

## Read the contract before writing

Each endpoint page is generated from the [OpenAPI document](/api-reference/openapi.json). Where an operation accepts a dynamic payload, the reference says which catalog supplies its schema.

A company is represented as `workspace_id` in the API. Preserve that identifier in requests even though the product calls it a company. JSON fields are case-sensitive.

Successful creation means a resource or execution request was accepted. Follow the Run and read its output to determine whether work completed. For fiscal work, preparation and professional review precede authorization of the exact version in the signed-in app. The state remains **Autorizado · en revisión** (authorized, under review) until a professional records the actual filing result. Check the external reference and receipt.


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