# Kontent.ai MCP for AI Agents AI Agent Connect

> Kontent.ai MCP lets you manage and fetch headless CMS content directly through your AI agent. It handles content types, taxonomies, and assets using both the Delivery and Management APIs, giving you a direct bridge to your headless content without leaving your workspace.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_GfuF8w3dkNLKGWMt1wJCLx0sDhpFazQrmNCQk1jQ/ai-agent-connect
- **Tags:** cms, api-first, content-delivery, content-management-api, taxonomy

## Description

Managing a complex headless CMS usually involves a lot of tab switching. You have to go to the dashboard to check a taxonomy, then back to your IDE to see how the data maps, then back again to update a translation. This Connector changes that by bringing your Kontent.ai project directly into your AI client. Instead of digging through the UI to find a specific taxonomy group or checking if a content item exists, you can just ask your agent to do it for you. It handles the heavy lifting of both content delivery and management. You can pull specific data for your front-end, create new content types to match your evolving schema, or swap out language variants without ever leaving your workspace. Whether you're auditing content across different collections or trying to understand a complex project structure, this connection lets you treat your CMS like a direct extension of your workflow. It's one of the many ways Vinkius helps you bridge the gap between your data and your AI tools. You get to focus on building and content strategy while your agent handles the tedious API calls and data retrieval. You can manage everything from high-level schema definitions down to individual asset updates using natural language.

## Tools

### manage_create_item
Create a new content item using the Management API. This helps you populate your CMS with new data quickly.

### manage_delete_item
Delete a content item via the Management API. This lets you remove specific content entries.

### manage_list_items
List content items via the Management API. This provides a broad overview of your content entries.

### manage_create_taxonomy
Create a taxonomy via the Management API. Use this to organize your content into custom groups.

### manage_create_type
Create a content type via the Management API. This is how you define the structure for new content.

### manage_delete_asset
Delete an asset via the Management API. Use this to remove images or files from your project.

### manage_delete_taxonomy
Delete a taxonomy via the Management API. Use this to remove categories or tags.

### manage_delete_type
Delete a content type via the Management API. This removes the definition of a content structure.

### manage_get_variant
Get a language variant of a content item. Use this to see how content looks in a specific language.

### manage_list_taxonomies
List taxonomies via the Management API. This helps you see all your organized categories.

### manage_list_types
List content types via the Management API. Use this to see all the content structures you've built.

### manage_update_asset
Update an asset via the Management API. Use this to modify existing files or images.

### manage_update_item
Update a content item via the Management API. This lets you edit the content of an existing entry.

### manage_update_taxonomy
Update a taxonomy via the Management API. Use this to change category names or structures.

### manage_update_type
Update a content type via the Management API. This lets you modify the schema of your content.

### manage_update_variant
Update a language variant of a content item. Use this to edit content for a specific region.

### delivery_get_item
Get a single content item via the Delivery API. This is the fastest way to pull data for your front-end.

### delivery_list_items
List content items via the Delivery API. This supports filtering and depth for targeted data retrieval.

### delivery_list_taxonomies
List taxonomies via the Delivery API. Use this to pull category data for your site.

### delivery_list_types
List content types via the Delivery API. This helps your agent understand your CMS structure.

### manage_list_assets
List assets via the Management API. This gives you a list of all files in your project.

### manage_create_asset
Create an asset via the Management API. Use this to upload new images or files to your CMS.

## Prompt Examples

**Prompt:** 
```
List all content items of type 'blog_post' from my Kontent.ai project.
```

**Response:** 
```
I've retrieved the blog posts. I found 3 items:

* **Welcome to our Blog**
* **Tech Trends 2024**
* **Headless CMS Guide**

Would you like to see the details for any of these?
```

**Prompt:** 
```
Get the content item with codename 'about_us_page'.
```

**Response:** 
```
Fetching 'about_us_page'... I've found the item.

* **Type:** page
* **Collection:** Main
* **Title:** About Our Company
* **Last Updated:** October 12th

Would you like me to fetch any language variants for this page?
```

**Prompt:** 
```
List all taxonomy groups in my project.
```

**Response:** 
```
I've fetched the taxonomies. Your project contains 2 groups:

| Group Name | Purpose |
| :--- | :--- |
| **Persona** | Targeting different audience segments |
| **Product Category** | Organizing your inventory |

Do you need more details on any of these groups?
```

## Capabilities

### Create content types and taxonomies
Define new content structures and organization categories via the Management API.

### Fetch filtered content items
Pull specific content data using filters for type, collection, and depth.

### Update language variants
Modify content for specific regions and languages without manual dashboard edits.

### Clean up assets and items
Delete old content entries or files to keep your CMS project organized.

### Inspect project schemas
View your content type definitions and taxonomy groups to understand your project structure.

### List all project assets
Get a complete overview of all images and files stored in your CMS.

## Use Cases

### Content Audit
A manager asks the agent to find all blog posts in the 'Main' collection and check their last update date using manage_list_items.

### Schema Building
A developer asks the agent to create a new content type for 'Product Reviews' with specific fields using manage_create_type.

### Localization
A marketer asks the agent to update the French version of the 'About Us' page to include new office details using manage_update_variant.

### Data Fetching
A developer asks for a list of all taxonomy groups to understand how the site organizes inventory using delivery_list_taxonomies.

## Benefits

- Stop switching tabs by using manage_list_items to see your content directly in your chat interface.
- Build your schema faster with manage_create_type and manage_create_taxonomy tools for instant structure updates.
- Update global content quickly using manage_update_variant to change specific language versions in seconds.
- Get precise front-end data with delivery_list_items which supports filtering and depth for targeted retrieval.
- Clean up your project easily by deleting old entries or files with manage_delete_item and manage_delete_asset.
- Audit your entire content structure in seconds using delivery_list_types and delivery_list_taxonomies.

## How It Works

The bottom line is you get a direct bridge to your headless CMS data without leaving your chat interface.

1. Connect your Kontent.ai Project ID and API keys to the Connector.
2. Select your preferred AI client like Claude or Cursor.
3. Ask your agent to perform content management or retrieval tasks.

## Frequently Asked Questions

**What is the Kontent.ai MCP?**
It connects your Kontent.ai CMS to your AI client so you can manage content, types, and taxonomies via chat.

**Can I use the Kontent.ai MCP to update translations?**
Yes, you can use it to update specific language variants for any content item directly through your agent.

**Does the Kontent.ai MCP work with my existing project?**
Yes, it connects to your specific project using your existing Project ID and API keys.

**Can my AI agent create new content types with this Connector?**
Yes, it can create new content types, taxonomies, and content items using the Management API.

**How do I manage my images and files using the Kontent.ai MCP?**
You can list, create, and delete assets like images or files directly through your AI client.

**Can I filter the content my agent sees in Kontent.ai?**
Yes, the Connector supports filtering by type, collection, and depth to ensure your agent retrieves the exact data you need.

**Can I filter content items by their content type?**
Yes. Use the `delivery_list_items` tool and provide the `system_type` parameter with the codename of the content type you want to filter by.

**Is it possible to create new content items using this server?**
Absolutely. The `manage_create_item` tool allows you to create new content items by providing a JSON payload according to the Kontent.ai Management API schema.

**How do I retrieve a specific language variant of a content item?**
You can use the `manage_get_variant` tool, providing both the `item_id` and the `language_id` to fetch the specific version of the content.