# Kontent.ai MCP > Kontent.ai MCP lets you manage structured content, assets, and taxonomies through natural language prompts. Get immediate access to Kontent's Delivery and Management APIs, letting your AI agent read specific articles, create new content types, or audit entire collections without touching the web console. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** cms, api-first, content-delivery, content-management-api, taxonomy ## Description Managing a headless CMS shouldn't feel like navigating a decade-old web application. This MCP connects your AI client directly to Kontent.ai's core structure, giving you full control over both delivery and management functions. You can ask your agent things like, 'List all blog posts from the last quarter that mention sustainability,' or 'Create a new content type for case studies.' Need to fix an asset? Just tell it to update the image linked to a specific page item. If your existing stack uses multiple tools, Vinkius makes sure this MCP is available right alongside them, giving you one central point of control. It handles everything from fetching data using the Delivery API to building out new content structures via the Management API. ## Tools ### delivery_get_item Fetches the full details for one specific content item using its unique identifier. ### delivery_list_items Retrieves a list of multiple content items, supporting filtering by type or collection depth. ### delivery_list_taxonomies Lists all taxonomy groups defined in your project's structure. ### delivery_list_types Gets a list of all available content types (schemas) used across the CMS. ### manage_list_assets Provides an overview and list of all digital assets attached to your project. ### manage_create_asset Uploads and registers a new asset (like an image or PDF) into the CMS repository. ### manage_create_item Generates a brand-new content item record, populating it with initial data. ### manage_create_taxonomy Establishes an entirely new taxonomy group to categorize your content. ### manage_create_type Defines a completely new content structure or schema for the CMS. ### manage_delete_asset Removes an asset from your project's repository entirely. ### manage_delete_item Permanently deletes a content item record from the CMS. ### manage_delete_taxonomy Removes an entire taxonomy group, which will orphan any associated content. ### manage_delete_type Deletes a defined content type schema from the CMS structure. ### manage_get_variant Retrieves a specific language version of an existing content item. ### manage_list_items Lists all content items when you need to see the current state of your records. ### manage_list_taxonomies Provides a list of existing taxonomies, useful for auditing and planning changes. ### manage_list_types Lists all available content types to check the current CMS schema definitions. ### manage_update_asset Modifies an existing asset, such as changing its metadata or associated file path. ### manage_update_item Changes the content of an existing item, like editing text or updating a date field. ### manage_update_taxonomy Modifies the settings or scope of an existing taxonomy group. ### manage_update_type Changes the fields or structure definition of a content type schema. ### manage_update_variant Updates specific translated text or data for one language version of an item. ## 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', and '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. It's a 'page' type item in the 'Main' collection. The title is 'About Our Company' and it was last updated on October 12th. ``` **Prompt:** ``` List all taxonomy groups in my project. ``` **Response:** ``` I've fetched the taxonomies. Your project contains 2 groups: 'Persona' (targeting different audience segments) and 'Product Category' (organizing your inventory). ``` ## Capabilities ### Retrieve specific content Fetch individual articles or asset details when you know the exact item code. ### Query and list collections List multiple content items, types, or taxonomy groups based on filters like collection or depth. ### Create new structure elements Build out the CMS by creating new content types, taxonomies, or asset records. ### Modify and delete data Update existing content items, change language variants, or clean up old assets. ## Use Cases ### Updating a global campaign message The marketing team needs to change the boilerplate copy on 50 product pages across four different languages. They ask their agent, 'Update all items of type 'product_page' with the new Q3 slogan.' The MCP handles this using manage_update_item and manages multiple language variants, saving them from editing each item individually. ### Restructuring product data The e-commerce team realizes they need to track 'Sustainability Score' on every product. They ask the agent to define a new field. The MCP responds by executing manage_create_type, defining the necessary schema and making the change available across all future content. ### Analyzing old content for cleanup A junior developer needs to find every item that hasn't been updated in three years. They prompt the agent, 'List items older than 1095 days.' The MCP uses delivery_list_items with advanced filtering, providing a clean list of stale records they can then triage. ### Preparing for new content lines The content team needs to start writing guides on 'AI Ethics' but has no category for them. They ask the agent to help organize it. The MCP executes manage_create_taxonomy, setting up a dedicated taxonomy group that keeps the new content separated and structured. ## Benefits - Audit content across languages instantly. You can use manage_get_variant and delivery_list_items to check the translated text for every single item in a collection, avoiding manual checks in multiple UI tabs. - Build complex data structures on demand. Need a new type? Use manage_create_type and define it right from your chat interface, specifying all required fields before any developer writes code. - Maintain content cleanliness automatically. Instead of manually deleting old assets or obsolete taxonomies, tell the agent to run cleanup using manage_delete_asset or manage_delete_taxonomy. - Accelerate development time. Developers can use delivery_list_types and delivery_get_item to pull schemas and payloads directly into their IDE for rapid integration testing, bypassing manual API endpoint calls. - Manage content lifecycle fully. You don't just retrieve data; you control it. Use manage_create_item or manage_update_item to push new drafts or corrections live with simple prompts. ## How It Works The bottom line is you never have to switch from chatting with your AI agent to navigating Kontent's admin panel again. 1. Subscribe to this MCP on Vinkius and provide your Kontent.ai Project ID along with the necessary Delivery and Management API keys. 2. Your AI client recognizes the available tools, making it ready to accept structured requests about your content structure. 3. You ask your agent a plain language question—like 'What are all my product categories?'—and it uses the correct tool to deliver the data. ## Frequently Asked Questions **How do I update an item using the Kontent.ai MCP?** You use manage_update_item to modify content. You just need to give the agent the unique ID of the item and tell it exactly which fields to change, like updating text or changing a date. **Can I list all available content types with the Kontent.ai MCP?** Yes, you use delivery_list_types. This tool shows you every schema currently defined in your project, so you know what kind of content exists to work with. **What's the difference between listing items and managing them via Kontent.ai MCP?** delivery_list_items reads data (viewing). manage_list_items is used when you want to list records that might be candidates for modification or cleanup. **How do I add a new category in Kontent.ai using this MCP?** To create a new category, use manage_create_taxonomy. You specify the name and scope of the taxonomy group, and the tool handles its creation. **Do I need to know specific IDs when I use delivery_get_item?** Yes, deliver_get_item requires a unique identifier for the content item. If you don't have the ID, start by using delivery_list_items to find it first.