# Agility CMS — how to use (mcp.ai)

Connect your Agility CMS account and use 9 tools for website builders straight from your AI agent. Connect with your own API key. Agility CMS is a headless content management system that allows developers to build and manage digital experiences across various platforms.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_agility_cms?ms=1787293380000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `agility_cms_get_api_types`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/agility_cms`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/agility_cms/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/agility_cms/get/api/types` — Tool to retrieve all enum types used throughout the Agility CMS Management API. Use when you need to understand available values for status codes, types, permissions, and other enumerated fields.
- `POST https://api.mcp.ai/api/agility_cms/get/content/item` — Tool to fetch details of a content item by Content ID. Use when you need item fields and metadata from Agility CMS.
  - body: { guid?: string, locale?: string, apiType?: string, content_id: integer, content_link_depth?: integer, expand_all_content_links?: boolean }
- `POST https://api.mcp.ai/api/agility_cms/get/content/list` — Retrieves a paginated list of content items by reference name from Agility CMS. Use this action to: - Fetch multiple content items of a specific type (e.g., blog posts, products, authors) - Retrieve c
  - body: { guid: string, skip?: integer, sort?: string, take?: integer, fields?: string, filter?: string, locale: string, apiType?: string, direction?: string, referenceName: string, contentLinkDepth?: integer, expandAllContentLinks?: boolean }
- `POST https://api.mcp.ai/api/agility_cms/get/content/models` — Tool to retrieve content models and page modules. Use when you need schema definitions to dynamically build content structures.
  - body: { guid?: string, apiType?: string, lastModifiedDate?: string }
- `POST https://api.mcp.ai/api/agility_cms/get/logs` — Retrieve sync items (content change logs) from Agility CMS using the Content Sync API. This tool implements incremental content synchronization: - Use syncToken='0' for initial full sync (retrieves al
  - body: { guid?: string, locale?: string, pageSize?: integer, syncToken: string }
- `POST https://api.mcp.ai/api/agility_cms/get/page` — Tool to retrieve details of a Page, including metadata, content zones, and components. Use after you know the page_id to fetch.
  - body: { locale?: string, page_id: integer, content_link_depth?: integer, expand_all_content_links?: boolean }
- `POST https://api.mcp.ai/api/agility_cms/get/page/modules` — Retrieves page module definitions from Agility CMS. Page modules are UI components that can be added to pages. This action fetches all model definitions and filters to return only page modules (defini
  - body: { guid?: string, locale?: string, apiType?: string, lastModifiedDate?: string }
- `POST https://api.mcp.ai/api/agility_cms/get/sitemap/flat` — Retrieves the flat sitemap for a specific channel and locale in Agility CMS. Returns a dictionary mapping page paths to sitemap items containing page metadata, SEO info, and routing details. Use this 
  - body: { guid: string, locale: string, apiType?: string, channelName: string }
- `POST https://api.mcp.ai/api/agility_cms/sync/pages` — Retrieves all page items from Agility CMS in paged format with sync tokens for incremental updates. Use this to synchronize local page data with the CMS. Start with syncToken=0 for initial sync, then 
  - body: { locale: string, pageSize?: integer, syncToken: integer }

## Example prompts
- "What can I do in Agility CMS?"
- "Show me a summary of my Agility CMS account"

## More
- Page: https://mcp.ai/agility_cms
- Agent spec (llms.txt): https://mcp.ai/agility_cms/llms.txt
- Postman collection: https://mcp.ai/agility_cms/postman.json