automations_create

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.

Create an Automation. Add schedule, webhook or connected app triggers with automations_triggers_create. Requires company edit access. Does not start a run. Availability: Autónomo / Empresa / Agents invitation. Catalog: Advanced (tools_search, then tools_call). The live catalog is authoritative: company type, membership, plan, connected apps and execution context can narrow this contract. Understand access.

Input

Agents schema

{
  "additionalProperties": false,
  "properties": {
    "area_id": {
      "description": "Area UUID. Omit to use the company root.",
      "type": "string"
    },
    "description": {
      "description": "Prompt / instructions.",
      "type": "string"
    },
    "harness": {
      "description": "Harness from workspace_status execution: melso (Melso, no computer) or a Cloud CLI such as codex or claude.",
      "type": "string"
    },
    "idempotency_key": {
      "description": "Optional unique key for this edit; reuse only for retries of the same create.",
      "type": "string"
    },
    "model": {
      "description": "Harness-native model ID.",
      "type": "string"
    },
    "service_tier": {
      "description": "Harness-native service tier.",
      "type": "string"
    },
    "task_title_template": {
      "description": "Created Task title template. Only {{date}} is supported.",
      "type": "string"
    },
    "thinking_level": {
      "description": "Harness-native thinking level.",
      "type": "string"
    },
    "title": {
      "description": "Automation title.",
      "type": "string"
    }
  },
  "required": [
    "title",
    "harness"
  ],
  "type": "object"
}

Autónomo / Company schema

{
  "additionalProperties": false,
  "properties": {
    "description": {
      "description": "Prompt / instructions.",
      "type": "string"
    },
    "idempotency_key": {
      "description": "Optional unique key for this edit; reuse only for retries of the same create.",
      "type": "string"
    },
    "task_title_template": {
      "description": "Created Task title template. Only {{date}} is supported.",
      "type": "string"
    },
    "title": {
      "description": "Automation title.",
      "type": "string"
    }
  },
  "required": [
    "title"
  ],
  "type": "object"
}

Output

The saved Automation or trigger configuration for this edit. A configuration receipt does not mean a scheduled Task has run. 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.

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. First discover automations_create with tools_search and confirm that the live schema permits these arguments.

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": "tools_call",
    "arguments": {
      "name": "automations_create",
      "arguments": {
        "title": "Weekly review",
        "description": "Summarize the open Tasks.",
        "harness": "codex"
      }
    }
  }
}
JSON

Connect

Contracts and access

Core tools

Agents and managed-Run tools

Advanced tools

automations_create

Input

Agents schema

Autónomo / Company schema

Output

Example

​Input

​Agents schema

​Autónomo / Company schema

​Output

​Example

Input

Agents schema

Autónomo / Company schema

Output

Example