bulk_validate
Validate multiple entries at once
LABSCO SUMMARY
An editorial change stops requiring the web app.
Updates merge rather than replace — send the fields and locales you are changing and everything else stays put — and publishing takes up to 100 entry IDs at once, which turns a content migration into a handful of calls. Pagination is the thing to plan around: entry search returns at most 3 items and content type listing at most 10 per request, so anything wide is a skip loop. AI Actions defined in the space are invokable from the same session as the edits they feed.
What it is
40 tools over the Contentful Management API: entries, assets, content types, spaces and environments, plus the space's AI Actions and threaded comments on entries.
What you get
- Entries searched, created, read, updated and deleted, and published or unpublished up to 100 IDs at a time through the bulk path
- Field-level merging on update, so only the fields and locales you send change, and bulk validation across a set of entry IDs before anything goes live
- Assets uploaded, updated, deleted, published and unpublished
- Content types created, updated, published, listed and deleted, with the field definitions readable first
- Spaces and environments listed, created and deleted
- AI Actions listed, created, updated, published and invoked with variables, and the result of an earlier invocation fetched by ID
- Threaded comments on an entry: created with a parent, read with status, updated and deleted
Requirements
A Contentful account and a Content Management API token in CONTENTFUL_MANAGEMENT_ACCESS_TOKEN. Space and environment IDs are supplied per call.
Setup effort
One command plus a key — npx -y @ivotoby/contentful-management-mcp-server --management-token <YOUR_MANAGEMENT_TOKEN>, then supply credentials
USE CASES
01
Publishing a batch of finished entries
Validate the set first, then publish up to 100 entry IDs in one call — the server takes the bulk path itself when given more than one.
02
Correcting one field across a locale
Updates merge with what is already there, so the call carries only the fields and locales that change — every value keyed by its locale.
03
Adding a content type and its first entry
Create the type, publish it, read its field definitions back, and create an entry against that ID — the field definitions are what the entry call needs to be correct.
04
Getting an image into a space
Upload the asset with its title and description, publish it, and update it later without repeating the upload.
05
Running a space's own AI Action
The AI Actions defined in the space can be invoked with variables from the same session as the edits, and an earlier invocation's result fetched by ID rather than waited for.
06
Leaving editorial feedback on an entry
Comments carry a status and can reply to a parent, so a review thread lives on the entry itself instead of in a separate tracker.
40 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
create_ai_action
Create a new AI Action
create_comment
Create a new comment on an entry. The comment will be created with the specified body and status. To create a threaded conversation (reply to an existing comment), provide the parent comment ID. This allows you to work around the 512-character limit by creating threaded replies.
create_content_type
Create a new content type
create_entry
Create a new entry in Contentful. Before executing this function, you need to know the contentTypeId (not the content type NAME) and the fields of that contentType. You can get the fields definition by using the GET_CONTENT_TYPE tool. IMPORTANT: All field values MUST include a locale key (e.g., 'en-US') for each value, like: { title: { 'en-US': 'My Title' } }. Every field in Contentful requires a locale even for single-language content.
create_environment
Create a new environment
delete_ai_action
Delete an AI Action
delete_asset
Delete an asset
delete_comment
Delete a specific comment from an entry.
delete_content_type
Delete a content type
delete_entry
Delete an entry
delete_environment
Delete an environment
get_ai_action
Get a specific AI Action by ID
get_ai_action_invocation
Get the result of a previous AI Action invocation
get_asset
Retrieve an asset
get_comments
Retrieve comments for an entry with pagination support. Returns comments with their status and body content.
get_content_type
Get details of a specific content type
get_entry
Retrieve an existing entry
get_single_comment
Retrieve a specific comment by its ID for an entry.
get_space
Get details of a space
invoke_ai_action
Invoke an AI Action with variables
list_ai_actions
List all AI Actions in a space
list_assets
List assets in a space. Returns a maximum of 3 items per request. Use skip parameter to paginate through results.
list_content_types
List content types in a space. Returns a maximum of 10 items per request. Use skip parameter to paginate through results.
list_environments
List all environments in a space
list_spaces
List all available spaces
publish_ai_action
Publish an AI Action
publish_asset
Publish an asset
publish_content_type
Publish a content type
publish_entry
Publish an entry or multiple entries. Accepts either a single entryId (string) or an array of entryIds (up to 100 entries). For a single entry, it uses the standard publish operation. For multiple entries, it automatically uses bulk publishing.
search_entries
Search for entries using query parameters. Returns a maximum of 3 items per request. Use skip parameter to paginate through results.
unpublish_ai_action
Unpublish an AI Action
unpublish_asset
Unpublish an asset
unpublish_entry
Unpublish an entry or multiple entries. Accepts either a single entryId (string) or an array of entryIds (up to 100 entries). For a single entry, it uses the standard unpublish operation. For multiple entries, it automatically uses bulk unpublishing.
update_ai_action
Update an existing AI Action
update_asset
Update an asset
update_comment
Update an existing comment on an entry. The handler will merge your updates with the existing comment data.
update_content_type
Update an existing content type. The handler will merge your field updates with existing content type data, so you only need to provide the fields and properties you want to change.
update_entry
Update an existing entry. The handler will merge your field updates with the existing entry fields, so you only need to provide the fields and locales you want to change. IMPORTANT: All field values MUST include a locale key (e.g., 'en-US') for each value, like: { title: { 'en-US': 'My Updated Title' } }. Every field in Contentful requires a locale even for single-language content.
upload_asset
Upload a new asset
BEFORE YOU INSTALL
What to know first
Tools you get
40 tools when we connected; the project documents 42. bulk_publish and bulk_unpublish are documented but did not appear on a default install. Nine AI Action tools depend on DISABLE_AI_ACTIONS and on your space having the feature; setting both SPACE_ID and ENVIRONMENT_ID removes the space and environment tools.
Requires
- npx on PATH
- CONTENTFUL_MANAGEMENT_ACCESS_TOKEN in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @ivotoby/contentful-management-mcp-server --management-token <YOUR_MANAGEMENT_TOKEN>MCP Clients
Claude Desktop — Token in env
CLAUDE DESKTOP — TOKEN IN ENV · JSON
{
"mcpServers": {
"contentful": {
"command": "npx",
"args": [
"-y",
"@ivotoby/contentful-management-mcp-server"
],
"env": {
"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<YOUR_CONTENTFUL_MANAGEMENT_ACCESS_TOKEN>"
}
}
}
}Claude Desktop — Token as argument
CLAUDE DESKTOP — TOKEN AS ARGUMENT · JSON
{
"mcpServers": {
"contentful": {
"command": "npx",
"args": [
"-y",
"@ivotoby/contentful-management-mcp-server",
"--management-token",
"<YOUR_TOKEN>",
"--host",
"http://api.contentful.com"
]
}
}
}HTTP server
HTTP SERVER · TERMINAL
npx -y @ivotoby/contentful-management-mcp-server --management-token <YOUR_MANAGEMENT_TOKEN> --http --port 3000
