MCP Tools

This page lists the MCP tools currently advertised by the backend.

Transport

Base route: /v1/ai/mcp
Method: POST for all tool endpoints
Authentication: Authorization: Bearer <token>

The endpoint column below is relative to the MCP router base and assumes v1.

Tool	Relative endpoint	Description
`cms.information.get`	`/tools/information/get`	Fetches the MCP capability document, including banner field metadata, required fields, relation wrappers, and page slug guidance.
`cms.configuration.get`	`/tools/configuration/get`	Returns safe runtime configuration including valid domains, multi-domain requirements, active locales, Search Console readiness, defaults, and feature flags.
`cms.pages.list`	`/tools/pages/list`	Lists page slugs and domains, optionally filtered by exact domain.
`cms.sitemap.get`	`/tools/sitemap/get`	Returns the current sitemap as textual XML for page overview and internal-link optimization.
`cms.cache.clear`	`/tools/cache/clear`	Clears the backend CMS GraphQL cache. Use only when the user reports stale or non-refreshing data.
`cms.pages.revalidate`	`/tools/pages/revalidate`	Queues frontend regeneration for a slug and optional domain. Use only when the user reports stale frontend data.
`cms.native_icons.list`	`/tools/native-icons/list`	Lists valid `@native-systems/icons` identifiers for CMS native-icon fields.
`cms.variables.fetch`	`/tools/variables/fetch`	Fetches one CMS variable by id or exact name.
`cms.variables.fetch_many`	`/tools/variables/fetch-many`	Fetches all CMS variables.
`cms.variables.create`	`/tools/variables/create`	Creates one CMS variable.
`cms.variables.update`	`/tools/variables/update`	Updates one CMS variable selected by id or exact name.
`cms.variables.delete`	`/tools/variables/delete`	Deletes one CMS variable selected by id or exact name.
`cms.search.query`	`/tools/search/query`	Queries the centralized global search index across products, deals, pages, and contacts.
`cms.themes.fetch`	`/tools/themes/fetch`	Fetches one CMS theme by id.
`cms.themes.fetch_many`	`/tools/themes/fetch-many`	Fetches multiple CMS themes by ids, or all themes when no ids are provided.
`cms.projects.create`	`/tools/projects/create`	Creates one MCP project for reusable page and banner generation context.
`cms.projects.fetch`	`/tools/projects/fetch`	Fetches one MCP project by id, slug, or exact name.
`cms.projects.fetch_many`	`/tools/projects/fetch-many`	Fetches multiple MCP projects by ids or slugs, or recent projects when no filters are provided.
`cms.projects.update`	`/tools/projects/update`	Updates one MCP project and can append note context for later sessions.
`cms.projects.use`	`/tools/projects/use`	Marks one MCP project as active and returns its latest persisted context.
`cms.pages.fetch`	`/tools/pages/fetch`	Fetches one CMS page by id or slug and returns page data plus preview metadata.
`cms.pages.fetch_many`	`/tools/pages/fetch-many`	Fetches multiple CMS pages by ids or slugs.
`cms.pages.keywords.search_console`	`/tools/pages/keywords/search-console`	Fetches page-specific Search Console queries for SEO-aware generation flows.
`cms.pages.create`	`/tools/pages/create`	Creates one CMS page and returns creation metadata plus the admin preview URL.
`cms.pages.update`	`/tools/pages/update`	Updates one CMS page and returns resolved page data plus preview metadata.
`cms.pages.delete`	`/tools/pages/delete`	Deletes one CMS page and returns deleted page metadata plus the captured preview URL.
`cms.banners.fetch`	`/tools/banners/fetch`	Fetches one CMS banner by id and returns resolved banner data plus preview metadata.
`cms.banners.fetch_many`	`/tools/banners/fetch-many`	Fetches multiple CMS banners by ids.
`cms.banners.create`	`/tools/banners/create`	Creates one CMS banner and returns creation metadata plus the admin preview URL.
`cms.banners.update`	`/tools/banners/update`	Updates one CMS banner and returns resolved banner data plus preview metadata.
`cms.banners.delete`	`/tools/banners/delete`	Deletes one or many CMS banners by id and returns deleted metadata plus preview URLs when available.
`cms.images.upload`	`/tools/images/upload`	Uploads one raster image to Keystone and returns metadata for banner relations.
`cms.videos.upload`	`/tools/videos/upload`	Uploads one video to Keystone and returns metadata for banner media relations.

Notes

Full request and response contracts come from the MCP information payload exposed by cms.information.get.
Call cms.configuration.get before domain-aware work. When multiple domains are configured and user intent is ambiguous, ask which domain to use.
For banner payload semantics, see MCP Banner Fields.
For authentication and OAuth setup, see MCP Authentication and MCP OAuth setup.