> ## 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. # tasks_create > Input, output and examples for the tasks_create MCP tool. 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). Delegate work to Melso by creating a Task. Read workspace\_status (include execution) first: with no connected AI account the model is billed to Melso credits. Input starts a Run using Area or Company defaults unless start=false. Pass execution to override the harness. Title-only creates stay idle. Reuse client\_request\_id after an uncertain response. **Availability:** Autónomo / Empresa / Agents invitation. **Catalog:** Core (`tools/list`). The live catalog is authoritative: company type, membership, plan, connected apps and execution context can narrow this contract. [Understand access](/mcp/permissions). ## Input ### Agents schema ```json theme={null} { "additionalProperties": false, "properties": { "area_id": { "description": "Optional Area UUID. Omit for Company context.", "type": "string" }, "attachment_ids": { "description": "Attachment UUIDs returned by multipart POST to the MCP URL plus /upload-file. Binds files to the Task and, if input is supplied, its first message.", "items": { "type": "string" }, "type": "array" }, "client_request_id": { "description": "Caller-generated UUID for safe create retries. Reuse it with identical arguments.", "type": "string" }, "description": { "description": "Optional editable summary; never used as execution instructions.", "type": "string" }, "execution": { "additionalProperties": false, "properties": { "harness": { "description": "Harness from workspace_status execution. melso is Melso, the platform agent: no computer unless it runs a command.", "enum": [ "codex", "claude", "cursor", "pi", "melso" ], "type": "string" }, "model": { "description": "Optional harness-native model; omit for the default.", "type": "string" }, "service_tier": { "description": "Optional service tier.", "type": "string" }, "thinking_level": { "description": "Optional thinking effort.", "type": "string" } }, "required": [ "harness" ], "type": "object" }, "input": { "description": "First conversation message. On workspace OAuth this starts a Run unless start=false.", "type": "string" }, "start": { "description": "Set false to save without running. When omitted, input starts a Run.", "type": "boolean" }, "title": { "description": "Short title; optional when input is supplied. Title-only creates stay idle.", "type": "string" } }, "type": "object" } ``` ### Autónomo / Company schema ```json theme={null} { "additionalProperties": false, "properties": { "attachment_ids": { "description": "Attachment UUIDs returned by multipart POST to the MCP URL plus /upload-file. Binds files to the Task and, if input is supplied, its first message.", "items": { "type": "string" }, "type": "array" }, "client_request_id": { "description": "Caller-generated UUID for safe create retries. Reuse it with identical arguments.", "type": "string" }, "description": { "description": "Optional editable summary; never used as execution instructions.", "type": "string" }, "input": { "description": "First conversation message. On workspace OAuth this starts a Run unless start=false.", "type": "string" }, "start": { "description": "Set false to save without running. When omitted, input starts a Run.", "type": "boolean" }, "title": { "description": "Short title; optional when input is supplied. Title-only creates stay idle.", "type": "string" } }, "type": "object" } ``` ### Managed run / agents schema ```json theme={null} { "additionalProperties": false, "properties": { "area_id": { "description": "Optional Area UUID. Omit for Company context.", "type": "string" }, "client_request_id": { "description": "Caller-generated UUID for safe create retries. Reuse it with identical arguments.", "type": "string" }, "description": { "description": "Optional editable summary; never used as execution instructions.", "type": "string" }, "input": { "description": "First conversation message. On workspace OAuth this starts a Run unless start=false.", "type": "string" }, "title": { "description": "Short title; optional when input is supplied. Title-only creates stay idle.", "type": "string" } }, "type": "object" } ``` ### Managed run / company / Managed run / freelancer schema ```json theme={null} { "additionalProperties": false, "properties": { "client_request_id": { "description": "Caller-generated UUID for safe create retries. Reuse it with identical arguments.", "type": "string" }, "description": { "description": "Optional editable summary; never used as execution instructions.", "type": "string" }, "input": { "description": "First conversation message. On workspace OAuth this starts a Run unless start=false.", "type": "string" }, "title": { "description": "Short title; optional when input is supplied. Title-only creates stay idle.", "type": "string" } }, "type": "object" } ``` ## Output An object with `task` (the compact Task projection) and `execution`. Execution `state` is `not_started`, `submitted`, or `inspect_required`; a submitted execution includes `run_id`. This is a receipt, not a completed result. 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](/mcp/results). ## 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. ```bash theme={null} 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": "tasks_create", "arguments": { "title": "Review the draft", "start": false } } } JSON ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.