Tags

Tags tools include field-level argument descriptions and runnable examples for MCP clients.

Tools Covered

Tool	Mutation	Backend Routes
`tags_assign_bulk`	Yes	`/tags/add-content-tags`
`tags_manage`	Yes	`/tags/manage-tags`

`tags_assign_bulk`

Assign tags to content in bulk.

Backend routes: /tags/add-content-tags

Arguments

Field	Type	Required	Description	Example
`content_ids`	array	Yes	List of content IDs to operate on.	`["KBD0215806635290000000000","KBD5567454989590000000000"]`
`tag_ids`	array	Yes	Tag IDs to assign.	`["TAG1775738821272014203913"]`
`viewer_id`	string	No	Optional explicit user context override. If omitted, MCP resolves this from the authenticated token/session.	`IGH6969811447860000000000`
`organisation_id`	string	No	Optional explicit organisation context override. If omitted, MCP resolves this from the authenticated token/session.	`PDX7478889578460000000000`
`idempotency_key`	string	No	Client supplied unique key for mutation safety. Re-using the same key returns the cached mutation result instead of executing again.	`mcp-mutation-2026-05-13-001`

Example Request

Bulk assign tags to content

{
  "jsonrpc": "2.0",
  "id": "tags_assign_bulk-1",
  "method": "tools/call",
  "params": {
    "name": "tags_assign_bulk",
    "arguments": {
      "content_ids": [
        "KBD0215806635290000000000"
      ],
      "tag_ids": [
        "TAG1775738821272014203913"
      ]
    }
  }
}

Example Success

{
  "success": true,
  "data": {
    "tool": "tags_assign_bulk",
    "note": "Payload shape depends on tenant data and backend route output."
  },
  "error": null
}

Example Failure

{
  "success": false,
  "data": null,
  "error": {
    "code": "INVALID_ARGUMENTS",
    "message": "Missing or invalid parameters for tags_assign_bulk.",
    "status": 400,
    "retryable": false
  }
}

`tags_manage`

Create/update/delete tags.

Backend routes: /tags/manage-tags

Arguments

Field	Type	Required	Description	Example
`tags`	array	Yes	Tag management payload rows used by `/tags/manage-tags` (create/update/delete state).	`[{"id":"TAG123","name":"Healthcare","color":"#0EA5E9"}]`
`preview_delete`	boolean	No	When true, returns impact preview for tag delete actions without applying changes.	`true`
`confirm`	boolean	No	Safety confirmation for destructive execution actions.	`true`
`viewer_id`	string	No	Optional explicit user context override. If omitted, MCP resolves this from the authenticated token/session.	`IGH6969811447860000000000`
`organisation_id`	string	No	Optional explicit organisation context override. If omitted, MCP resolves this from the authenticated token/session.	`PDX7478889578460000000000`
`idempotency_key`	string	No	Client supplied unique key for mutation safety. Re-using the same key returns the cached mutation result instead of executing again.	`mcp-mutation-2026-05-13-001`

Example Request

Create or update tag definitions

{
  "jsonrpc": "2.0",
  "id": "tags_manage-1",
  "method": "tools/call",
  "params": {
    "name": "tags_manage",
    "arguments": {
      "tags": [
        {
          "id": "TAG1775738821272014203913",
          "name": "Healthcare",
          "color": "#0EA5E9"
        }
      ],
      "preview_delete": false,
      "confirm": true
    }
  }
}

Example Success

{
  "success": true,
  "data": {
    "tool": "tags_manage",
    "note": "Payload shape depends on tenant data and backend route output."
  },
  "error": null
}

Example Failure

{
  "success": false,
  "data": null,
  "error": {
    "code": "INVALID_ARGUMENTS",
    "message": "Missing or invalid parameters for tags_manage.",
    "status": 400,
    "retryable": false
  }
}