Model Context Protocol Server

Agility CMS
MCP Server

Connect AI tools directly to Agility CMS for seamless content management. Create, update, and manage your headless CMS content through Claude and other AI assistants.

Why Choose Agility's MCP Server?

Get enterprise-level content management capabilities directly in your AI workflow.

AI-First Integration

Built specifically for AI tools using the Model Context Protocol. No APIs to learn, just natural conversation.

Enterprise Security

OAuth 2.0 authentication ensures secure access to your Agility CMS instances and content models.

Full Content Control

Create, read, and manage content models and page components with comprehensive field type support.

33 Powerful MCP Tools at Your Fingertips

Complete toolkit for managing Agility CMS content models, components, locales, sitemaps, media assets, and content items through AI.

Discovery & Setup

Start here to understand what instances, locales, and containers are available before you read or write content.

get_available_instances

Lists every Agility CMS instance the authenticated user can access.

Parameters:None (uses auth token)
Returns:Array of instances with `guid`, `name`, `org`, and `appUrl` grouped by organization for easy browsing.

get_current_user

Identifies the Agility user the current OAuth token authenticates as.

Parameters:All optional
Returns:Safe identity fields: `userID`, `userName`, `emailAddress`, `firstName`, `lastName`, `adminAccess`, `isSuspended`, `userTypeID`, `jobRole`, and the count of accessible instances.

get_locales

Retrieves all locales configured for an instance.

Parameters:instanceGuid
Returns:Array of locale records containing locale name and locale code.

get_containers

Lists content containers (lists and singletons) for an instance.

Parameters:instanceGuid
Returns:Array of container definitions including display name, ID, reference name, content definition name, and category. Includes totalCount, filteredCount, skip, and take metadata.

Modeling & Schema

Inspect and manage the underlying content and component schemas that power your Agility CMS implementation.

get_content_models

Lists all content models for an instance.

Parameters:instanceGuid
Returns:Array of content models with identifiers and display information.

get_component_models

Lists all component models for an instance.

Parameters:instanceGuid
Returns:Array of component models with display names, references, and IDs.

get_page_models

Lists all page models for an instance and locale.

Parameters:instanceGuid, locale
Returns:Array of page models with display names, IDs, and configuration details.

save_page_model

Creates or updates a page model (page template) and its content zones.

Parameters:instanceGuid, locale, name, zones
Returns:Saved page model including its `pageTemplateID` and the resolved content zone reference names.

get_content_model_details

Returns the full definition for a specific content model.

Parameters:instanceGuid
Returns:Content model metadata including display information, description, and an array of fields with type information.

get_component_model_details

Returns the full definition for a specific component model.

Parameters:instanceGuid
Returns:Component model metadata including display information, description, and detailed field configuration.

save_content_model

Creates or updates a content model using the enhanced model schema.

Parameters:instanceGuid, model
Returns:Saved content model including updated IDs, reference name, and persisted field configuration.

save_component_model

Creates or updates a component model using the enhanced model schema.

Parameters:instanceGuid, model
Returns:Saved component model with IDs, reference name, and resolved field configuration.

Content Retrieval

Fetch content in bulk or read a single item to inform prompts, transformations, or audits.

get_content_items

Retrieves a paged list of content items for a container.

Parameters:instanceGuid, referenceName, locale
Returns:Structured list containing items with system properties and a dynamic `fields` object plus pagination counts.

get_content_item

Retrieves one or more content items by ID.

Parameters:instanceGuid, locale
Returns:Single item: full content item with properties, fields, SEO, and scripts. Batch: items array with optional errors array for failed retrievals.

search_instance

Searches one instance's content, components, pages, assets, models and containers.

Parameters:instanceGuid, query
Returns:Total, per-kind facet counts, a `relaxed` flag (no hit matched every word), indexing status, and hits with kind, name, context, a highlighted snippet, IDs, locale, state, modified date and a Content Manager link.

get_sitemaps

Lists all digital channels (sitemaps) for an instance.

Parameters:instanceGuid, locale
Returns:Array of channel summaries with `digitalChannelID` and `name` properties only.

get_sitemap

Retrieves a specific sitemap with filtering options.

Parameters:instanceGuid, locale
Returns:Nested page tree or flat page list with page IDs, URLs, types, and dynamic content references.

get_page

Retrieves a single page by ID.

Parameters:instanceGuid, pageID, locale
Returns:Complete page object with all zones, component references, SEO configuration, and page metadata.

Content Management

Create or update content structures and entries once your prompts have prepared valid payloads.

save_content_items

Creates or updates one or more content items with pre-save validation.

Parameters:instanceGuid, locale, items
Returns:An `items` array in the same order as the input. Each entry has `saved: true` with a `contentID`, or `saved: false` with an `error` message. Also includes `savedCount` and `failedCount` totals. If every item fails, throws an error with per-item details instead.

save_container

Creates or updates a container definition.

Parameters:instanceGuid, container
Returns:Saved container metadata including IDs, reference names, and display information.

publish_content

Publishes one or more content items (takes them live).

Parameters:instanceGuid, locale, contentIDs
Returns:Per-item results with `succeededIDs` and any `failed` entries.

unpublish_content

Unpublishes one or more content items (takes them offline).

Parameters:instanceGuid, locale, contentIDs
Returns:Per-item results with `succeededIDs` and any `failed` entries.

manage_content_workflow

Approves, declines, or requests approval for content items.

Parameters:instanceGuid, locale, operation, contentIDs
Returns:Per-operation results with `succeededIDs` and any `failed` entries.

delete_content_item

Deletes one or more content items.

Parameters:instanceGuid, locale, contentIDs
Returns:Per-item results with `deletedIDs` and any `failed` entries.

Sitemap & Pages

Create, update, and manage pages and their module layouts within your site's sitemap structure.

save_page

Creates or updates a page in Agility CMS.

Parameters:instanceGuid, locale, page
Returns:Page ID of the created or updated page along with success metadata.

reorder_page_modules

Reorders modules within a page zone.

Parameters:instanceGuid, locale, pageID, zoneName, moduleContentIDs
Returns:Confirmation with the new module order and page ID.

publish_page

Publishes one or more pages (takes them live).

Parameters:instanceGuid, locale, pageIDs
Returns:Per-page results with `succeededIDs` and any `failed` entries.

unpublish_page

Unpublishes one or more pages (takes them offline).

Parameters:instanceGuid, locale, pageIDs
Returns:Per-page results with `succeededIDs` and any `failed` entries.

manage_page_workflow

Approves, declines, or requests approval for pages.

Parameters:instanceGuid, locale, operation, pageIDs
Returns:Per-operation results with `succeededIDs` and any `failed` entries.

delete_page

Deletes one or more pages.

Parameters:instanceGuid, locale, pageIDs
Returns:Per-page results with `deletedIDs` and any `failed` entries.

Media & Assets

Upload images and files from URLs or local paths to the Agility CMS media library.

initialize_media_upload

Initialize a media asset upload and receive a temporary signed URL.

Parameters:instanceGuid
Returns:Upload signature including `uploadUrl`, `uploadToken`, `expiresAt` timestamp, and usage instructions.

list_media

Lists media assets in the media library, paged.

Parameters:instanceGuid
Returns:`items` array of assets plus `totalCount`.

delete_media

Deletes a media asset by mediaID.

Parameters:instanceGuid, mediaID
Returns:Confirmation with the deleted `mediaID`.

20+ Field Types for Any Content Need

From simple text to complex linked content relationships, we've got you covered.

📝 Basic Fields

  • • Text Field
  • • Long Text Field
  • • HTML Field
  • • Boolean Field
  • • Integer Field
  • • Decimal Field
  • • Date Field

🎯 Selection Fields

  • • Dropdown List
  • • Link Field
  • • Search Listbox
  • • Checkboxes
  • • Dropdown

🎨 Media Fields

  • • Image Attachment
  • • File Attachment

🔗 Shared Content

  • • Shared Grid
  • • Shared Link

📋 Nested Content

  • • Nested Grid
  • • Nested Link

📂 Organization Fields

  • • Tab Field
  • • Custom Section

⚡ Advanced Types

  • • Complex Object Fields
  • • Custom Field Types
  • • Rich Text Editor

Start Your 30-Day Free Trial

Experience the full power of Agility CMS with complete access to all features for 30 days. No credit card required.

Try All Features Risk-Free for 30 Days

Get full access to enterprise-grade content management, unlimited API calls, premium support, and all advanced features. Cancel anytime during your trial with no obligations.

Start 30-Day Free Trial

No credit card required • Cancel anytime

Full Enterprise Access

Access all premium features, unlimited users, and enterprise-grade security for 30 days.

No Commitments

Cancel anytime during your trial. No contracts, no hidden fees, no obligations.

Premium Support

Get priority support from our expert team throughout your trial period.

Ready to Get Started?

Connect your favorite AI tools to Agility CMS in just a few minutes with our step-by-step setup guide.

Complete Setup Instructions

Follow our detailed guide to connect GitHub Copilot, Cursor, Windsurf, Claude Code, and other popular AI tools to your Agility CMS instances.

Start Setup Now

Secure OAuth

Authenticate safely with your Agility CMS organization

Quick Setup

Get connected in under 5 minutes with our guide

Start Creating

Begin managing content with AI assistance immediately