# Contentful MCP for AI Agents AI Agent Connect > Contentful lets your AI agent directly interact with your headless CMS. It can pull content, draft new entries, and manage your assets or content models without you having to switch tabs or manually copy-paste data between your editor and the CMS. Get your structured content into production faster by letting your agent handle the heavy lifting of data entry and schema discovery. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_FRRtFHq5L2okvsPTtqPaQuDBSQN9uVdkt6TR3UVB/ai-agent-connect - **Tags:** api-first, content-modeling, digital-assets, structured-content, content-delivery ## Description Think about how much time you spend tab-switching between your AI chat and your CMS. You want your agent to do the work, but usually, you're the one doing the heavy lifting of copy-pasting text into entries, checking schemas, or hunting for the right image assets in another tab. This Connector fixes that by giving your agent a direct line into your Contentful workspace. It can pull your existing content, draft new entries, and even explore your content models to see what's possible. You can have your agent draft a whole article based on a conversation you just had and save it as a draft in one go. Because it's part of the Vinkius catalog, you can get this connected quickly and start treating your CMS like a direct extension of your chat. It's about getting your content into production without the friction of manual data entry. Instead of a tedious back-and-forth, you get a streamlined flow where your agent understands your content types and can execute updates or retrievals exactly when you need them. Whether you're auditing hundreds of records or just trying to get one image live, this connection removes the middleman. It turns your content repository into an interactive workspace where the AI actually knows what's going on. ## Tools ### get_content_type Get the specific details of a content type. This helps you understand the schema of your content models. ### list_content_types See all content types in your environment. This gives your agent a map of your content structure. ### list_entries Get a list of all entries in your environment. This helps with auditing or finding specific records. ### list_environments See the different environments in your space. This helps you stay in the right context. ### list_organizations See all organizations in your Contentful account. This helps manage high-level access. ### list_spaces See all available Contentful spaces. Use this to navigate between different project areas. ### publish_entry Move a draft entry into a published state. This takes a draft live with a single command. ### unpublish_entry Move a published entry back to a draft state. Use this to take content offline quickly. ### update_entry Modify an existing entry in your CMS. Use this to make quick edits to live or draft content. ### create_entry Create a new entry in a draft state. This lets your agent draft content for you to review. ### get_entry Pull the full details of a specific entry. It's the fastest way to see what's inside a record. ### list_assets See every asset in your current environment. This is great for finding specific images or files. ## Prompt Examples **Prompt:** ``` Find all the content types in our 'Marketing' space. ``` **Response:** ``` I've looked into your space and found the following content types: | Content Type | Description | | :--- | :--- | | Blog Post | Main article format | | Product Page | E-commerce listing | | Hero Banner | Homepage visual | Would you like me to dive into the details of any specific one? ``` **Prompt:** ``` Draft a new blog post entry about 'The Future of Headless CMS' and save it as a draft. ``` **Response:** ``` I've created a new draft for 'The Future of Headless CMS' in your Contentful space. Here's a summary of what I included: * **Title**: The Future of Headless CMS * **Slug**: future-of-headless-cms * **Body**: [The summary you provided has been formatted into a rich text body.] The entry is currently in **Draft** status. You can review it in your dashboard now. Would you like me to make any edits to the text? ``` **Prompt:** ``` What assets do we have in our current environment? ``` **Response:** ``` I've scanned your environment and found the following assets: | Asset Name | Type | ID | | :--- | :--- | :--- | | Hero_Banner | Image | img_01 | | Logo_Primary | Image | img_02 | | Brand_Video | Video | vid_05 | Let me know if you'd like more details on any of these or if you need help finding something else. ``` ## Capabilities ### Draft new content entries Have your agent create new content in draft mode for you to review. ### Pull content details Get full details on any existing record instantly. ### Manage content status Move entries from drafts to published states with a command. ### Explore content models Query your content types to understand your schemas. ### Search digital assets Find images and files within your environment quickly. ### Navigate spaces and environments See your entire CMS architecture across different spaces. ## Use Cases ### Drafting a blog post from a conversation A content creator asks the agent to turn a chat summary into a blog post. The agent uses `create_entry` to save it to Contentful as a draft. ### Checking content schemas during development A developer needs to know the fields for a product page. The agent uses `get_content_type` to show the schema instantly. ### Finding specific images for a marketing plan A marketer asks for a specific logo. The agent uses `list_assets` to find the file in the space without manual browsing. ### Quickly taking down an old article An editor needs to unpublish a post. The agent uses `unpublish_entry` to move it back to draft status in one step. ## Benefits - Stop copy-pasting text from your chat into the CMS by using `create_entry` to draft content directly into your workspace. - Get instant clarity on your content structure by letting your agent use `list_content_types` to map out your schemas. - Speed up your publishing cycle by using `publish_entry` to take drafts live without having to navigate menus. - Find specific images and files faster by having your agent use `list_assets` to scan your environment for you. - Manage multiple environments more easily by using `list_environments` to ensure your agent is always working in the right space. ## How It Works The bottom line is your AI becomes a direct editor for your headless CMS. 1. Connect the Contentful MCP to your AI client. 2. Provide your Contentful Personal Access Token for authorization. 3. Tell your agent to find, create, or update your content. ## Frequently Asked Questions **Can the Contentful MCP create new entries for me?** Yes, it can draft new entries directly in your workspace. Your agent can take a prompt or a summary and save it as a draft for you to review. **Does the Contentful MCP allow me to manage my assets?** Yes, it can list and find assets within your environment. This makes it much faster to locate specific images or files for your content. **Can I use the Contentful MCP to see my content schemas?** Yes, it pulls content types and details. This allows your agent to understand the structure of your data so it can write content that fits your models perfectly. **Is the Contentful MCP good for multi-environment management?** Yes, it can list environments in your space. This helps ensure your agent is always working in the correct environment, whether it's staging or production. **Can the Contentful MCP handle publishing?** Yes, it can move entries from draft to published status. You can command your agent to take a piece of content live once you're satisfied with it. **How do I generate a Contentful Personal Access Token?** Log into your Contentful dashboard. Click on your profile picture in the top right corner and navigate to **Account Settings**. Locate **Personal Access Tokens** and click 'Generate Personal Token'. Copy the value provided. **Do I need the Space ID to use this integration?** Yes. Most actions the AI performs require your specific Space ID to target the correct content repository effectively. **Can the agent interact with unpublished draft entries directly?** Yes, Contentful's Content Management API (CMA) natively handles internal content regardless of publish state. You can command your AI to fetch, check, or structure a draft before hitting the publish flag explicitly.