Available tools for CMS 13

The CMS Opal Tools package provides AI-powered tools for content management. Opal invokes all tools and requires Opti ID authentication.

Content type tools

Manage content type definitions in CMS. These tools require CMS administrator permissions.

• paas_cms_list_content_types – Lists all content types in CMS, optionally filtered by base type (_page, _component, _media, _image, _video). Returns type name, key, base type, and property count.

  Parameter	Type	Required	Description
  baseType	string	No	Filter by base type: _page, _component, _media, _image, _video

• paas_cms_get_content_type_details – Retrieves detailed information about a specific content type, including all property definitions with types, validation rules, and group assignments.

  Parameter	Type	Required	Description
  contentTypeKey	string	Yes	The key (name) of the content type

• paas_cms_create_content_type – Creates a new content type with a key, display name, base type, and property definitions. Properties support types like string, richtext, number, boolean, contentReference, and contentArea.

  Parameter	Type	Required	Description
  key	string	Yes	Unique machine-readable key (for example, NewsArticle).
  displayName	string	Yes	Human-readable name (for example, News Article).
  description	string	No	Description of the content type's purpose.
  baseType	string	Yes	Base type: _page, _block, _component, _media, _image, or _video.
  properties	string	No	JSON array of property definitions.

• paas_cms_update_content_type – Modifies an existing content type's display name, description, or property definitions. Can add, update, or remove properties.

  Parameter	Type	Required	Description
  contentTypeKey	string	Yes	The key of the content type to update.
  displayName	string	No	New display name.
  description	string	No	New description.
  properties	string	No	JSON array of property definitions to add or update.

• paas_cms_delete_content_type – Deletes a content type from CMS. The content type must not have any existing content instances.

  Parameter	Type	Required	Description
  contentTypeKey	string	Yes	The key of the content type to delete.

Property group tools

Manage property groups (tabs) used to organize content type properties in the editing UI. These tools require CMS administrator permissions.

• paas_cms_list_property_groups – Lists all property groups in the CMS with their names and sort order.

• paas_cms_create_property_group – Creates a new property group with a unique key and optional sort order.

  Parameter	Type	Required	Description
  key	string	Yes	Unique machine-readable key (for example, SEO_Settings).
  sortOrder	integer	No	Display sort order in the CMS UI (default: 100).

Content item tools

Create, read, update, and delete content items. All operations respect the authenticated user's CMS permissions.

• paas_cms_create_content_item – Creates a new content item as a draft. Returns a contentKey (GUID) and contentVersion for subsequent operations. Pages require a routeSegment and blocks must be placed in a folder container.

  Parameter	Type	Required	Description
  contentType	string	Yes	Name of the content type to create.
  displayName	string	Yes	Display name for the content item.
  container	string	No	GUID of the parent content item.
  routeSegment	string	No	URL segment for page routing (for example, about-us).
  locale	string	Yes	Locale code (for example, en or sv).

• paas_cms_get_content_data – Retrieves a content item's data including all non-metadata properties. Fetches a specific version or the latest published version.

  Parameter	Type	Required	Description
  contentKey	string	Yes	GUID of the content item.
  contentVersion	integer	No	Specific version number (omit for latest published).

• paas_cms_update_content_item – Updates properties on a content item. Accepts a JSON object of property name and value pairs. For rich text properties, retrieve the existing value first and append new content.

  Parameter	Type	Required	Description
  contentKey	string	Yes	GUID of the content item.
  contentVersion	integer	Yes	Version number to update.
  properties	string	Yes	JSON object of property name and value pairs.

• paas_cms_delete_content_item – Moves a content item to the waste basket. An editor can restore the item.

  Parameter	Type	Required	Description
  contentKey	string	Yes	GUID of the content item to delete.

• paas_cms_publish_content_item – Publishes a content item immediately or schedules it for a future date and time. Requires a content version number.

  Parameter	Type	Required	Description
  contentKey	string	Yes	GUID of the content item.
  contentVersion	integer	Yes	Version number to publish.
  scheduledPublishDate	string	No	ISO 8601 date and time for scheduled publishing.

Content variation tool

Create locale variations (translations) of existing content items.

• paas_cms_create_content_variation – Creates a new locale variation of a page or experience content item. After creation, use paas_cms_update_content_item to set properties that differ from the default version.

  Parameter	Type	Required	Description
  contentKey	string	Yes	GUID of the content item.
  variationKey	string	Yes	Unique key for the variation (for example, Holiday2024).
  locale	string	No	Locale code for the variation.
  displayName	string	No	Display name (defaults to variation key).

Preview tool

Generate preview URLs for content items.

• paas_cms_get_content_preview_url – Generates a preview URL for a specific content version, letting Opal fetch and analyze the rendered HTML.

  Parameter	Type	Required	Description
  contentKey	string	Yes	GUID of the content item.
  contentVersion	integer	Yes	Version number to preview.

SEO tools

AI-powered SEO analysis and editing capabilities.

• paas_cms_seo_analysis – Analyzes content SEO performance and provides AI-powered recommendations. Extracts all content properties and metadata for comprehensive analysis including title tags, meta descriptions, heading structure, and keyword optimization.

  Parameter	Type	Required	Description
  contentKey	string	Yes	GUID of the content item.
  question	string	No	Focus area for the analysis.
  previewUrl	string	No	Preview URL for rendered HTML analysis.

• paas_cms_seo_edit – Applies SEO recommendations to CMS content. Provides an interactive form for editing SEO fields such as meta titles, descriptions, and social media tags. Use after running SEO analysis.

  Parameter	Type	Required	Description
  contentKey	string	Yes	GUID of the content item.
  recommendedValues	string	No	JSON object of recommended SEO values.
  actualPropertyNames	string	No	JSON object mapping SEO field names to CMS property names.

GEO tools

Analyze content for LLM discoverability and apply JSON-LD schema markup.

• paas_cms_geo_analysis – Performs an AI-powered audit of content for LLM discoverability. Analyzes reachability, robots controls, structured data, content clarity, performance signals, and so on. Generates JSON-LD schema recommendations.

  Parameter	Type	Required	Description
  contentKey	string	Yes	GUID of the content item.
  previewUrl	string	Yes	Preview URL for the rendered page.
  question	string	No	Focus area for the analysis.

• paas_cms_geo_apply – Applies JSON-LD schema templates to the content's JsonLdTemplates property. Creates a new draft version with the schema markup.

  Parameter	Type	Required	Description
  contentKey	string	Yes	GUID of the content item.
  jsonLdTemplates	string	Yes	JSON-LD schema templates to apply.