# Contentful MCP

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** api-first, content-modeling, digital-assets, structured-content, content-delivery

## Tools

### get_content_type
Get details of a specific content type

### update_entry
Update an existing entry

### create_entry
Create a new entry in draft state

### get_entry
Get details of a specific entry

### list_assets
List all assets in the current environment

### list_spaces
List all Contentful spaces available

### publish_entry
Publish a draft entry

### unpublish_entry
Unpublish an entry (return to draft)

### list_content_types
List all content types in the current environment

### list_entries
List entries in the current environment

### list_environments
List environments in the current space

### list_organizations
List all Contentful organizations

## Prompt Examples

**Prompt:** 
```
Retrieve the details and full content for the article titled 'AI Best Practices' from space ID 'xvz1'.
```

**Response:** 
```
Content successfully fetched. The article 'AI Best Practices' in space 'xvz1' is currently marked as a 'Draft'. Here's a brief summary of the text: ... Would you like to update the conclusion paragraph natively?
```

**Prompt:** 
```
Fetch the structure schema of our 'Blog Post' content model.
```

**Response:** 
```
Here is the content layout details for 'Blog Post': It holds a 'title' string, a unique 'slug', a 'richText' body implementation, an 'author' internal reference link, and an 'asset' featured image ID. Do you want to prepare a new instance using this schema?
```

**Prompt:** 
```
List all environments in our current Contentful space.
```

**Response:** 
```
I've retrieved the environments for your space. You have 'master' (Active), 'staging' (Active), and 'development' (Active). Which environment would you like to use for querying entries?
```

## Frequently Asked Questions

**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.