Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Contentful MCP connector

OAuth 2.1/DCR Files & DocumentsProductivityCollaboration

Connect to Contentful MCP. Manage spaces, entries, assets, content types, and taxonomies in your Contentful CMS from AI workflows.

Contentful MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'contentfulmcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Contentful MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'contentfulmcp_get_initial_context',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Asset upload, unpublish, unarchive — Upload a new asset to Contentful from a URL or file handle
  • Update locale, entry, editor interface — Update an existing locale’s settings such as name, fallback, or API access flags
  • Entry unpublish, unarchive, publish — Unpublish one or more entries, removing them from the Content Delivery API
  • Type unpublish content, publish content — Unpublish a content type so it can no longer be used to create new entries
  • Action unpublish ai, publish ai, invoke ai — Unpublish an AI action, removing it from the available actions in the editor
  • Search entries — Search for entries in a Contentful space using flexible query parameters including field filters and full-text search

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

contentfulmcp_archive_asset # Archive one or more assets that are no longer needed but should be preserved. 3 params

Archive one or more assets that are no longer needed but should be preserved.

Name Type Required Description
assetId string required The unique identifier of the asset.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_archive_entry # Archive one or more entries that are no longer needed but should be preserved. 3 params

Archive one or more entries that are no longer needed but should be preserved.

Name Type Required Description
entryId string required The unique identifier of the entry.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_create_ai_action # Create a new AI action with a prompt instruction template, model configuration, and optional test cases. 7 params

Create a new AI action with a prompt instruction template, model configuration, and optional test cases.

Name Type Required Description
configuration object required The configuration for the AI action
description string required An optional description for the resource.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
instruction object required The instruction for the AI action
name string required A human-readable name for the resource.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
testCases array optional Test cases for the AI action
contentfulmcp_create_concept # Create a new taxonomy concept with labels, definitions, and hierarchical relationships. 15 params

Create a new taxonomy concept with labels, definitions, and hierarchical relationships.

Name Type Required Description
organizationId string required The unique identifier of the Contentful organization.
prefLabel object required The preferred label for the concept (localized)
altLabels object optional Alternative labels for the concept (localized)
broader array optional Links to broader concepts
conceptId string optional The unique identifier of the taxonomy concept.
definition object optional Definition of the concept (localized)
editorialNote object optional Editorial note for the concept (localized)
example object optional Example for the concept (localized)
hiddenLabels object optional Hidden labels for the concept (localized)
historyNote object optional History note for the concept (localized)
notations array optional An array of notation strings for this concept.
note object optional General note for the concept (localized)
related array optional An array of related concept IDs.
scopeNote object optional Scope note for the concept (localized)
uri string optional A unique URI identifying this concept or concept scheme.
contentfulmcp_create_concept_scheme # Create a new taxonomy concept scheme for organizing related concepts. 11 params

Create a new taxonomy concept scheme for organizing related concepts.

Name Type Required Description
organizationId string required The unique identifier of the Contentful organization.
prefLabel object required The preferred label for the concept scheme (localized)
conceptSchemeId string optional The unique identifier of the taxonomy concept scheme.
definition object optional Definition of the concept scheme (localized)
editorialNote object optional Editorial note for the concept scheme (localized)
example object optional Example for the concept scheme (localized)
historyNote object optional History note for the concept scheme (localized)
note object optional General note for the concept scheme (localized)
scopeNote object optional Scope note for the concept scheme (localized)
topConcepts array optional Links to top-level concepts in this scheme
uri string optional A unique URI identifying this concept or concept scheme.
contentfulmcp_create_content_type # Create a new content type with the specified fields in a Contentful environment. 8 params

Create a new content type with the specified fields in a Contentful environment.

Name Type Required Description
displayField string required The ID of the field to use as the display field for the content type.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fields array required Array of field definitions for the content type
name string required A human-readable name for the resource.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentTypeId string optional The ID of the content type. Use list_content_types to look up available IDs.
description string optional An optional description for the resource.
metadata object optional No description.
contentfulmcp_create_entry # Create a new entry of a specified content type with the provided field values. 5 params

Create a new entry of a specified content type with the provided field values.

Name Type Required Description
contentTypeId string required The ID of the content type. Use list_content_types to look up available IDs.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fields object required The field values for the new entry. Keys should be field IDs and values should be the field content.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
metadata object optional No description.
contentfulmcp_create_environment # Create a new environment in a Contentful space, optionally cloning from an existing one. 4 params

Create a new environment in a Contentful space, optionally cloning from an existing one.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
name string required A human-readable name for the resource.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
sourceEnvironmentId string optional The ID of the environment to clone when creating the new environment.
contentfulmcp_create_locale # Create a new locale in a Contentful environment with the specified language code and settings. 9 params

Create a new locale in a Contentful environment with the specified language code and settings.

Name Type Required Description
code string required The locale code in BCP 47 format (e.g. 'en-US', 'de-DE').
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fallbackCode string required The locale code to fall back to when content is not available in this locale.
name string required A human-readable name for the resource.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentDeliveryApi boolean optional Whether this locale is enabled for the Content Delivery API.
contentManagementApi boolean optional Whether this locale is enabled for the Content Management API.
default boolean optional Whether this locale is the default locale for the environment.
optional boolean optional Whether this locale is optional (allows missing translations).
contentfulmcp_create_tag # Create a new tag with the specified ID, name, and visibility in a Contentful environment. 5 params

Create a new tag with the specified ID, name, and visibility in a Contentful environment.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
id string required The unique identifier for the tag (must be unique within the environment).
name string required A human-readable name for the resource.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
visibility string required Controls tag visibility. Accepted values: public, private.
contentfulmcp_create_upload_session # Create a short-lived upload session for staging a binary file to Contentful before creating an asset. 0 params

Create a short-lived upload session for staging a binary file to Contentful before creating an asset.

contentfulmcp_delete_ai_action # Permanently delete an AI action from a Contentful environment. 3 params

Permanently delete an AI action from a Contentful environment.

Name Type Required Description
aiActionId string required The unique identifier of the AI action.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_delete_asset # Permanently delete an asset from a Contentful environment. 3 params

Permanently delete an asset from a Contentful environment.

Name Type Required Description
assetId string required The unique identifier of the asset.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_delete_concept # Permanently delete a taxonomy concept by its ID and version number. 3 params

Permanently delete a taxonomy concept by its ID and version number.

Name Type Required Description
conceptId string required The unique identifier of the taxonomy concept.
organizationId string required The unique identifier of the Contentful organization.
version number required The current version number of the resource, used for optimistic concurrency control.
contentfulmcp_delete_concept_scheme # Permanently delete a taxonomy concept scheme by its ID and version number. 3 params

Permanently delete a taxonomy concept scheme by its ID and version number.

Name Type Required Description
conceptSchemeId string required The unique identifier of the taxonomy concept scheme.
organizationId string required The unique identifier of the Contentful organization.
version number required The current version number of the resource, used for optimistic concurrency control.
contentfulmcp_delete_content_type # Permanently delete an unpublished content type from a Contentful environment. 3 params

Permanently delete an unpublished content type from a Contentful environment.

Name Type Required Description
contentTypeId string required The ID of the content type. Use list_content_types to look up available IDs.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_delete_entry # Permanently delete an entry from a Contentful environment. 3 params

Permanently delete an entry from a Contentful environment.

Name Type Required Description
entryId string required The unique identifier of the entry.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_delete_environment # Permanently delete an environment from a Contentful space. 2 params

Permanently delete an environment from a Contentful space.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_delete_locale # Permanently delete a locale from a Contentful environment. 3 params

Permanently delete a locale from a Contentful environment.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
localeId string required The unique identifier of the locale (e.g. 'en-US').
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_ai_action # Retrieve details of a specific AI action including its instruction template and configuration. 3 params

Retrieve details of a specific AI action including its instruction template and configuration.

Name Type Required Description
aiActionId string required The unique identifier of the AI action.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_ai_action_invocation # Retrieve the result and status of a specific AI action invocation. 4 params

Retrieve the result and status of a specific AI action invocation.

Name Type Required Description
aiActionId string required The unique identifier of the AI action.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
invocationId string required The unique identifier of the AI action invocation.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_asset # Retrieve details of a specific asset including its file metadata and upload status. 3 params

Retrieve details of a specific asset including its file metadata and upload status.

Name Type Required Description
assetId string required The unique identifier of the asset.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_concept # Retrieve details of a specific taxonomy concept including labels and relationships. 2 params

Retrieve details of a specific taxonomy concept including labels and relationships.

Name Type Required Description
conceptId string required The unique identifier of the taxonomy concept.
organizationId string required The unique identifier of the Contentful organization.
contentfulmcp_get_concept_scheme # Retrieve details of a specific taxonomy concept scheme including its top-level concepts. 2 params

Retrieve details of a specific taxonomy concept scheme including its top-level concepts.

Name Type Required Description
conceptSchemeId string required The unique identifier of the taxonomy concept scheme.
organizationId string required The unique identifier of the Contentful organization.
contentfulmcp_get_content_type # Retrieve the field definitions and metadata of a specific content type. 3 params

Retrieve the field definitions and metadata of a specific content type.

Name Type Required Description
contentTypeId string required The ID of the content type. Use list_content_types to look up available IDs.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_editor_interface # Retrieve the editor interface configuration for a specific content type. 3 params

Retrieve the editor interface configuration for a specific content type.

Name Type Required Description
contentTypeId string required The ID of the content type. Use list_content_types to look up available IDs.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_entry # Retrieve a single entry by its ID from a Contentful space and environment. 3 params

Retrieve a single entry by its ID from a Contentful space and environment.

Name Type Required Description
entryId string required The unique identifier of the entry.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_initial_context # Retrieve initial context and usage instructions for the Contentful MCP server. Call this before using other tools. 0 params

Retrieve initial context and usage instructions for the Contentful MCP server. Call this before using other tools.

contentfulmcp_get_locale # Retrieve details of a specific locale including its fallback and API settings. 3 params

Retrieve details of a specific locale including its fallback and API settings.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
localeId string required The unique identifier of the locale (e.g. 'en-US').
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_org # Retrieve details of a specific Contentful organization by its ID. 1 param

Retrieve details of a specific Contentful organization by its ID.

Name Type Required Description
organizationId string required The unique identifier of the Contentful organization.
contentfulmcp_get_space # Retrieve details of a specific Contentful space by its ID. 1 param

Retrieve details of a specific Contentful space by its ID.

Name Type Required Description
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_invoke_ai_action # Execute an AI action with the specified variable values and return the generated result. 4 params

Execute an AI action with the specified variable values and return the generated result.

Name Type Required Description
aiActionId string required The unique identifier of the AI action.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fields array required No description.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_list_ai_actions # Retrieve a paginated list of AI actions defined in a Contentful environment. 7 params

Retrieve a paginated list of AI actions defined in a Contentful environment.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
include number optional Number of levels of linked entries to resolve and include in the response.
limit number optional Maximum number of items to return per page (max 1000).
order string optional Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
select string optional Comma-separated list of fields to include in the response.
skip number optional Number of items to skip for pagination.
contentfulmcp_list_assets # Retrieve a paginated list of assets in a Contentful environment with optional filters. 9 params

Retrieve a paginated list of assets in a Contentful environment with optional filters.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
include number optional Number of levels of linked entries to resolve and include in the response.
limit number optional Maximum number of items to return per page (max 1000).
links_to_entry string optional Return only assets or entries that link to the specified entry ID.
locale string optional The locale code to filter results by (e.g. 'en-US').
order string optional Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
select string optional Comma-separated list of fields to include in the response.
skip number optional Number of items to skip for pagination.
contentfulmcp_list_concept_schemes # Retrieve taxonomy concept schemes in a Contentful organization. 2 params

Retrieve taxonomy concept schemes in a Contentful organization.

Name Type Required Description
organizationId string required The unique identifier of the Contentful organization.
query string optional Query parameters for listing concept schemes, supports either pageUrl for cursor-based pagination. Offset "skip" pagination is not supported.
contentfulmcp_list_concepts # Retrieve taxonomy concepts in a Contentful organization with optional ancestor/descendant traversal. 9 params

Retrieve taxonomy concepts in a Contentful organization with optional ancestor/descendant traversal.

Name Type Required Description
organizationId string required The unique identifier of the Contentful organization.
conceptId string optional The unique identifier of the taxonomy concept.
getAncestors boolean optional Set to true to return ancestor concepts of the specified concept.
getDescendants boolean optional Set to true to return descendant concepts of the specified concept.
getTotalOnly boolean optional Set to true to return only the total count of concepts.
include number optional Number of levels of linked entries to resolve and include in the response.
limit number optional Maximum number of items to return per page (max 1000).
order string optional Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
select string optional Comma-separated list of fields to include in the response.
contentfulmcp_list_content_types # Retrieve a paginated list of content types in a Contentful environment. 7 params

Retrieve a paginated list of content types in a Contentful environment.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
include number optional Number of levels of linked entries to resolve and include in the response.
limit number optional Maximum number of items to return per page (max 1000).
order string optional Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
select string optional Comma-separated list of fields to include in the response.
skip number optional Number of items to skip for pagination.
contentfulmcp_list_editor_interfaces # Retrieve editor interface configurations for all content types in an environment. 2 params

Retrieve editor interface configurations for all content types in an environment.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_list_environments # Retrieve a paginated list of environments within a Contentful space. 6 params

Retrieve a paginated list of environments within a Contentful space.

Name Type Required Description
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
environmentId string optional The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
limit number optional Maximum number of items to return per page (max 1000).
order string optional Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
select string optional Comma-separated list of fields to include in the response.
skip number optional Number of items to skip for pagination.
contentfulmcp_list_locales # Retrieve a paginated list of locales configured in a Contentful environment. 7 params

Retrieve a paginated list of locales configured in a Contentful environment.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
include number optional Number of levels of linked entries to resolve and include in the response.
limit number optional Maximum number of items to return per page (max 1000).
order string optional Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
select string optional Comma-separated list of fields to include in the response.
skip number optional Number of items to skip for pagination.
contentfulmcp_list_orgs # Retrieve a paginated list of Contentful organizations the user belongs to. 4 params

Retrieve a paginated list of Contentful organizations the user belongs to.

Name Type Required Description
limit number optional Maximum number of items to return per page (max 1000).
order string optional Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
select string optional Comma-separated list of fields to include in the response.
skip number optional Number of items to skip for pagination.
contentfulmcp_list_spaces # Retrieve a paginated list of Contentful spaces accessible to the authenticated user. 4 params

Retrieve a paginated list of Contentful spaces accessible to the authenticated user.

Name Type Required Description
limit number optional Maximum number of items to return per page (max 1000).
order string optional Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
select string optional Comma-separated list of fields to include in the response.
skip number optional Number of items to skip for pagination.
contentfulmcp_list_tags # Retrieve a paginated list of tags in a Contentful environment. 6 params

Retrieve a paginated list of tags in a Contentful environment.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
limit number optional Maximum number of items to return per page (max 1000).
order string optional Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
select string optional Comma-separated list of fields to include in the response.
skip number optional Number of items to skip for pagination.
contentfulmcp_publish_ai_action # Publish an AI action to make it available for use in the Contentful editor. 3 params

Publish an AI action to make it available for use in the Contentful editor.

Name Type Required Description
aiActionId string required The unique identifier of the AI action.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_publish_asset # Publish one or more assets to make them available via the Content Delivery API. 3 params

Publish one or more assets to make them available via the Content Delivery API.

Name Type Required Description
assetId string required The unique identifier of the asset.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_publish_content_type # Publish a content type to make it available for creating entries. 3 params

Publish a content type to make it available for creating entries.

Name Type Required Description
contentTypeId string required The ID of the content type. Use list_content_types to look up available IDs.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_publish_entry # Publish one or more entries to make them available via the Content Delivery API. 3 params

Publish one or more entries to make them available via the Content Delivery API.

Name Type Required Description
entryId string required The unique identifier of the entry.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_search_entries # Search for entries in a Contentful space using flexible query parameters including field filters and full-text search. 3 params

Search for entries in a Contentful space using flexible query parameters including field filters and full-text search.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
query object required Flexible search parameters supporting ANY Contentful API query parameter. Use fields.* for field searches, sys.* for system fields, and any other Contentful API parameter.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_unarchive_asset # Restore one or more archived assets to make them available for editing again. 3 params

Restore one or more archived assets to make them available for editing again.

Name Type Required Description
assetId string required The unique identifier of the asset.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_unarchive_entry # Restore one or more archived entries to make them available for editing again. 3 params

Restore one or more archived entries to make them available for editing again.

Name Type Required Description
entryId string required The unique identifier of the entry.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_unpublish_ai_action # Unpublish an AI action, removing it from the available actions in the editor. 3 params

Unpublish an AI action, removing it from the available actions in the editor.

Name Type Required Description
aiActionId string required The unique identifier of the AI action.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_unpublish_asset # Unpublish one or more assets, removing them from the Content Delivery API. 3 params

Unpublish one or more assets, removing them from the Content Delivery API.

Name Type Required Description
assetId string required The unique identifier of the asset.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_unpublish_content_type # Unpublish a content type so it can no longer be used to create new entries. 3 params

Unpublish a content type so it can no longer be used to create new entries.

Name Type Required Description
contentTypeId string required The ID of the content type. Use list_content_types to look up available IDs.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_unpublish_entry # Unpublish one or more entries, removing them from the Content Delivery API. 3 params

Unpublish one or more entries, removing them from the Content Delivery API.

Name Type Required Description
entryId string required The unique identifier of the entry.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_update_ai_action # Update an existing AI action's instruction, configuration, or test cases. 8 params

Update an existing AI action's instruction, configuration, or test cases.

Name Type Required Description
aiActionId string required The unique identifier of the AI action.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
configuration object optional The configuration for the AI action
description string optional An optional description for the resource.
instruction object optional The instruction for the AI action
name string optional A human-readable name for the resource.
testCases array optional Test cases for the AI action
contentfulmcp_update_asset # Update an existing asset's fields or file metadata. 5 params

Update an existing asset's fields or file metadata.

Name Type Required Description
assetId string required The unique identifier of the asset.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fields object required The field values to update. Keys should be field IDs and values should be the field content. Will be merged with existing fields.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
metadata object optional No description.
contentfulmcp_update_concept # Update an existing taxonomy concept's labels, relationships, or metadata. 16 params

Update an existing taxonomy concept's labels, relationships, or metadata.

Name Type Required Description
conceptId string required The unique identifier of the taxonomy concept.
organizationId string required The unique identifier of the Contentful organization.
version number required The current version number of the resource, used for optimistic concurrency control.
altLabels object optional Alternative labels for the concept (localized)
broader array optional Links to broader concepts
definition object optional Definition of the concept (localized)
editorialNote object optional Editorial note for the concept (localized)
example object optional Example for the concept (localized)
hiddenLabels object optional Hidden labels for the concept (localized)
historyNote object optional History note for the concept (localized)
notations array optional An array of notation strings for this concept.
note object optional General note for the concept (localized)
prefLabel object optional The preferred label for the concept (localized)
related array optional An array of related concept IDs.
scopeNote object optional Scope note for the concept (localized)
uri string optional A unique URI identifying this concept or concept scheme.
contentfulmcp_update_concept_scheme # Update an existing taxonomy concept scheme's labels, definitions, or top-level concepts. 13 params

Update an existing taxonomy concept scheme's labels, definitions, or top-level concepts.

Name Type Required Description
conceptSchemeId string required The unique identifier of the taxonomy concept scheme.
organizationId string required The unique identifier of the Contentful organization.
version number required The current version number of the resource, used for optimistic concurrency control.
addConcept string optional The ID of the concept to add as a top-level concept in the scheme.
definition object optional Definition of the concept scheme (localized)
editorialNote object optional Editorial note for the concept scheme (localized)
example object optional Example for the concept scheme (localized)
historyNote object optional History note for the concept scheme (localized)
note object optional General note for the concept scheme (localized)
prefLabel object optional The preferred label for the concept scheme (localized)
scopeNote object optional Scope note for the concept scheme (localized)
topConcepts array optional Links to top-level concepts in this scheme
uri string optional A unique URI identifying this concept or concept scheme.
contentfulmcp_update_content_type # Update an existing content type's fields or metadata, merging with existing definitions. 8 params

Update an existing content type's fields or metadata, merging with existing definitions.

Name Type Required Description
contentTypeId string required The ID of the content type. Use list_content_types to look up available IDs.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
description string optional An optional description for the resource.
displayField string optional The ID of the field to use as the display field for the content type.
fields array optional Array of field definitions for the content type. Will be merged with existing fields.
metadata object optional No description.
name string optional A human-readable name for the resource.
contentfulmcp_update_editor_interface # Update the field controls, sidebar widgets, and layout for a content type editor. 7 params

Update the field controls, sidebar widgets, and layout for a content type editor.

Name Type Required Description
contentTypeId string required The ID of the content type. Use list_content_types to look up available IDs.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
controls array optional Array of control definitions for fields in the content type. Each control defines which widget to use for a field.
editorLayout array optional Editor layout configuration for organizing fields
groupControls array optional Array of group control definitions for field groups
sidebar array optional Array of sidebar widget configurations
contentfulmcp_update_entry # Update an existing entry by merging the provided field values with the existing ones. 5 params

Update an existing entry by merging the provided field values with the existing ones.

Name Type Required Description
entryId string required The unique identifier of the entry.
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fields object required The field values to update. Keys should be field IDs and values should be the field content. Will be merged with existing fields.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
metadata object optional No description.
contentfulmcp_update_locale # Update an existing locale's settings such as name, fallback, or API access flags. 4 params

Update an existing locale's settings such as name, fallback, or API access flags.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fields object required No description.
localeId string required The unique identifier of the locale (e.g. 'en-US').
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_upload_asset # Upload a new asset to Contentful from a URL or file handle. 7 params

Upload a new asset to Contentful from a URL or file handle.

Name Type Required Description
environmentId string required The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
file object required The file information for the asset. Prefer file.uploadHandle for remote uploads so the client can stage raw bytes to the worker first.
spaceId string required The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
title string required The title of the asset.
description string optional An optional description for the resource.
locale string optional The locale code to filter results by (e.g. 'en-US').
metadata object optional No description.