# Agility CMS MCP server

> Enables AI clients to access and manage content, models, pages, and media within Agility CMS instances through natural language conversation.

- Repository: https://github.com/agility/mcp-server
- Page: https://hostedmcp.org/servers/agility/mcp-server
- Transport: remote
- Stars: 0
- License: Apache-2.0
- Latest version: 2.12.13

## Install

### Claude Code

```sh
claude mcp add --transport http mcp-server https://mcp.agilitycms.com/api/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.agilitycms.com/api/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.agilitycms.com/api/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp-server","type":"http","url":"https://mcp.agilitycms.com/api/mcp"}'
```

### Codex

```sh
codex mcp add mcp-server --url https://mcp.agilitycms.com/api/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp-server]
url = "https://mcp.agilitycms.com/api/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http mcp-server https://mcp.agilitycms.com/api/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.agilitycms.com/api/mcp",
      "type": "http"
    }
  }
}
```

## Tools (33)

- `get_available_instances`
- `get_current_user`
- `get_containers`
- `search_instance`
- `get_content_models`
- `get_component_models`
- `get_content_model_details`
- `get_component_model_details`
- `get_locales`
- `get_content_items`
- `get_content_item`
- `save_content_items`
- `publish_content`
- `unpublish_content`
- `manage_content_workflow`
- `delete_content_item`
- `get_sitemaps`
- `get_sitemap`
- `get_page`
- `get_page_models`
- `save_page_model`
- `save_page`
- `reorder_page_modules`
- `publish_page`
- `unpublish_page`
- `manage_page_workflow`
- `delete_page`
- `initialize_media_upload`
- `list_media`
- `delete_media`
- `save_content_model`
- `save_component_model`
- `save_container`

## FAQ

### Do I need to install anything to use the Agility CMS MCP server?

No, it is a hosted server that you point your client to via a URL.

### How does the server handle authentication and permissions?

The server uses OAuth 2.0, and your existing Agility organization permissions serve as the authority for all actions.

### What kind of tasks can the AI perform with this server?

The server provides 33 tools that allow an AI to manage content, models, components, containers, pages, sitemaps, and media.
