skills

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.

Read and manage the company’s skills, which Runs install next to Melso’s built-in skills: scope company means every Run gets one, scope areas only Runs of Tasks in its area_ids. search and install reach skills.sh, GitHub and ClawHub; install follows the source until someone edits the skill here. delete removes a skill from every Run. To save a skill from its SKILL.md text, find skills_save with tools_search. Each action accepts only its own fields (* required): list; get(id*); search(query*); install(source*, area_ids, on_conflict); update(id*, area_ids, auto_update, from_source, scope); delete(id*). 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.

Input

Agents / Autónomo / Company schema

{
  "additionalProperties": false,
  "properties": {
    "action": {
      "enum": [
        "list",
        "get",
        "search",
        "install",
        "update",
        "delete"
      ],
      "type": "string"
    },
    "area_ids": {
      "description": "Area UUIDs. Only Runs of Tasks in these Areas get the skill.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "auto_update": {
      "description": "Follow the skill's source: install its updates daily.",
      "type": "boolean"
    },
    "from_source": {
      "description": "Install the latest version from the skill's source now.",
      "type": "boolean"
    },
    "id": {
      "description": "Skill UUID or name.",
      "type": "string"
    },
    "on_conflict": {
      "description": "When a skill with that name exists. Defaults to fail.",
      "enum": [
        "fail",
        "overwrite",
        "rename",
        "skip"
      ],
      "type": "string"
    },
    "query": {
      "description": "What the skill should do, at least 2 characters.",
      "type": "string"
    },
    "scope": {
      "description": "company: every Run gets it. areas: only Runs of Tasks in area_ids.",
      "enum": [
        "company",
        "areas"
      ],
      "type": "string"
    },
    "source": {
      "description": "The skill's URL, owner/repo@skill, or an `npx skills add` command naming one skill.",
      "type": "string"
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

Actions

The family schema combines fields for discovery. Each action accepts only its own fields below; add action when calling the family.

delete

Delete a skill. Runs stop receiving it.

{
  "additionalProperties": false,
  "properties": {
    "id": {
      "description": "Skill UUID or name.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

get

Read one skill: its SKILL.md, its text files, and the path and size of each binary file.

{
  "additionalProperties": false,
  "properties": {
    "id": {
      "description": "Skill UUID or name.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

install

Install a published skill, binary files included, from a skills.sh, GitHub or ClawHub URL, owner/repo@skill, or a pasted npx skills add command (read, never run). It follows its source: updates install automatically until someone edits it here. The whole company gets it unless area_ids is set.

{
  "additionalProperties": false,
  "properties": {
    "area_ids": {
      "description": "Area ids (from areas list). Only Runs of Tasks in these Areas get the skill.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "on_conflict": {
      "description": "When a skill with that name exists. Defaults to fail.",
      "enum": [
        "fail",
        "overwrite",
        "rename",
        "skip"
      ],
      "type": "string"
    },
    "source": {
      "description": "The skill's URL, owner/repo@skill, or an `npx skills add` command naming one skill.",
      "type": "string"
    }
  },
  "required": [
    "source"
  ],
  "type": "object"
}

list

List the company’s skills. scope company means every Run gets one; scope areas means only Runs of Tasks in its area_ids do. config.origin shows where one came from and whether it follows that source.

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

Search skills.sh for published skills. Each result has its install URL, install count and security audit verdict.

{
  "additionalProperties": false,
  "properties": {
    "query": {
      "description": "What the skill should do, at least 2 characters.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

update

Install the latest version of a skill from its source (from_source; this also discards edits made here and resumes updates), turn following its source on or off (auto_update), or change who gets it (scope).

{
  "additionalProperties": false,
  "properties": {
    "area_ids": {
      "description": "Area ids (from areas list). Only Runs of Tasks in these Areas get the skill.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "auto_update": {
      "description": "Follow the skill's source: install its updates daily.",
      "type": "boolean"
    },
    "from_source": {
      "description": "Install the latest version from the skill's source now.",
      "type": "boolean"
    },
    "id": {
      "description": "Skill UUID or name.",
      "type": "string"
    },
    "scope": {
      "description": "company: every Run gets it. areas: only Runs of Tasks in area_ids.",
      "enum": [
        "company",
        "areas"
      ],
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

Output

Skill search results, a Skill’s metadata/content, or the installed/updated/deleted result for the selected action. 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.

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

Connect

Contracts and access

Core tools

Agents and managed-Run tools

Advanced tools

Input

Agents / Autónomo / Company schema

Actions

Output

Example

​Input

​Agents / Autónomo / Company schema

​Actions

​Output

​Example

Input

Agents / Autónomo / Company schema

Actions

Output

Example