Tags

Last updated: May 15, 2026

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
  }
}