artifacts_manage

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.

Rename, publish/rollback, unpublish, archive or restore with expected_revision and request_id. Publish requires completed version_id. Explicit public and bindings change policy; omitted values retain current policy. Public grants permit reads or create-only submissions; fields are explicit. Any authorized member or agent may publish. Archive preserves every version; rollback preserves live table data and current grants. 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 / Autónomo / Company schema

{
  "$defs": {
    "filter": {
      "additionalProperties": false,
      "properties": {
        "and": {
          "items": {
            "additionalProperties": true,
            "description": "A nested filter using the same and/or/not or property_id/op/value shape. Boolean filters may nest up to 8 levels.",
            "type": "object"
          },
          "maxItems": 20,
          "type": "array"
        },
        "not": {
          "additionalProperties": true,
          "description": "A nested filter using the same and/or/not or property_id/op/value shape. Boolean filters may nest up to 8 levels.",
          "type": "object"
        },
        "op": {
          "enum": [
            "eq",
            "ne",
            "gt",
            "gte",
            "lt",
            "lte",
            "contains",
            "is_empty"
          ],
          "type": "string"
        },
        "or": {
          "items": {
            "additionalProperties": true,
            "description": "A nested filter using the same and/or/not or property_id/op/value shape. Boolean filters may nest up to 8 levels.",
            "type": "object"
          },
          "maxItems": 20,
          "type": "array"
        },
        "property_id": {
          "type": "string"
        },
        "value": {}
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "action": {
      "enum": [
        "rename",
        "publish",
        "rollback",
        "unpublish",
        "archive",
        "restore"
      ],
      "type": "string"
    },
    "artifact_id": {
      "format": "uuid",
      "type": "string"
    },
    "bindings": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "actions": {
            "items": {
              "enum": [
                "query",
                "get",
                "create",
                "update",
                "archive",
                "file"
              ],
              "type": "string"
            },
            "maxItems": 6,
            "type": "array"
          },
          "collection_id": {
            "format": "uuid",
            "type": "string"
          },
          "fields": {
            "items": {
              "type": "string"
            },
            "maxItems": 100,
            "type": "array"
          },
          "filter": {
            "$ref": "#/$defs/filter"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "collection_id",
          "fields",
          "actions"
        ],
        "type": "object"
      },
      "maxItems": 25,
      "type": "array"
    },
    "expected_revision": {
      "minimum": 1,
      "type": "integer"
    },
    "public": {
      "type": "boolean"
    },
    "request_id": {
      "format": "uuid",
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "version_id": {
      "format": "uuid",
      "type": "string"
    }
  },
  "required": [
    "action",
    "artifact_id",
    "request_id",
    "expected_revision"
  ],
  "type": "object"
}

Output

The selected lifecycle, sharing, rollback, launch, renewal, or data-operation result. Public access requires an explicit publication 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. First discover artifacts_manage 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": "artifacts_manage",
      "arguments": {
        "action": "rename",
        "artifact_id": "11111111-1111-4111-8111-111111111111",
        "expected_revision": 1,
        "request_id": "11111111-1111-4111-8111-111111111111",
        "title": "Reviewed draft"
      }
    }
  }
}
JSON

Connect

Contracts and access

Core tools

Agents and managed-Run tools

Advanced tools

artifacts_manage

Input

Agents / Autónomo / Company schema

Output

Example

​Input

​Agents / Autónomo / Company schema

​Output

​Example

Input

Agents / Autónomo / Company schema

Output

Example