The Contentful MCP connector routes your AI agent's tool calls to Contentful's own MCP server through Scalekit. Each user signs in to Contentful once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 85 tools.
- Tools
- 85
- What they doRead · write · destructive
- 34 · 32 · 1934 read32 write19 destructive
- Users sign in with
- OAuth
- OAuth app
- Scalekit's or your own
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the Contentful MCP connection
In AgentKit > Connections, create a Contentful MCP connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Scalekit credentials are available for Contentful MCP server, so you don't need to register an OAuth app.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'contentfulmcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Contentful MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'contentfulmcp_get_initial_context',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "contentfulmcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Contentful MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="contentfulmcp_get_initial_context",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcontentfulmcp_get_ai_actionRetrieve details of a specific AI action including its instruction template and configuration.Read-onlyGet Ai Action
Retrieve details of a specific AI action including its instruction template and configuration.
Inputs
aiActionIdstringrequired- The unique identifier of the AI action.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_ai_action_invocationRetrieve the result and status of a specific AI action invocation.Read-onlyGet Ai Action Invocation
Retrieve the result and status of a specific AI action invocation.
Inputs
aiActionIdstringrequired- The unique identifier of the AI action.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
invocationIdstringrequired- The unique identifier of the AI action invocation.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_assetRetrieve details of a specific asset including its file metadata and upload status.Read-onlyGet Asset
Retrieve details of a specific asset including its file metadata and upload status.
Inputs
assetIdstringrequired- The unique identifier of the asset.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_conceptRetrieve details of a specific taxonomy concept including labels and relationships.Read-onlyGet Concept
Retrieve details of a specific taxonomy concept including labels and relationships.
Inputs
conceptIdstringrequired- The unique identifier of the taxonomy concept.
organizationIdstringrequired- The unique identifier of the Contentful organization.
contentfulmcp_get_concept_schemeRetrieve details of a specific taxonomy concept scheme including its top-level concepts.Read-onlyGet Concept Scheme
Retrieve details of a specific taxonomy concept scheme including its top-level concepts.
Inputs
conceptSchemeIdstringrequired- The unique identifier of the taxonomy concept scheme.
organizationIdstringrequired- The unique identifier of the Contentful organization.
contentfulmcp_get_content_typeRetrieve the field definitions and metadata of a specific content type.Read-onlyGet Content Type
Retrieve the field definitions and metadata of a specific content type.
Inputs
contentTypeIdstringrequired- The ID of the content type. Use list_content_types to look up available IDs.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_editor_interfaceRetrieve the editor interface configuration for a specific content type.Read-onlyGet Editor Interface
Retrieve the editor interface configuration for a specific content type.
Inputs
contentTypeIdstringrequired- The ID of the content type. Use list_content_types to look up available IDs.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_entryRetrieve a single entry by its ID from a Contentful space and environment.Read-onlyGet Entry
Retrieve a single entry by its ID from a Contentful space and environment.
Inputs
entryIdstringrequired- The unique identifier of the entry.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_entry_preview_urlResolve the draft-preview URL for an entry by substituting the entry's data into the content preview URL template configured for its content type.Read-onlyGet Entry Preview Url
Resolve the draft-preview URL for an entry by substituting the entry's data into the content preview URL template configured for its content type. Returns the same link an editor would get from the Content Preview dropdown in the entry editor, plus any tokens that could not be resolved.
Inputs
entryIdstringrequired- The ID of the entry to build a preview URL for
environmentIdstringrequired- The ID of the Contentful environment
spaceIdstringrequired- The ID of the Contentful space
localestring- Locale code substituted into the {locale} token. Defaults to the space default locale.
previewIdstring- ID of the content preview to use. Defaults to the first preview with an enabled configuration for the entry content type. Use list_content_previews to see the options.
contentfulmcp_get_entry_snapshotRetrieve version history (snapshots) of an entry for safe rollback.Read-onlyGet Entry Snapshot
Retrieve version history (snapshots) of an entry for safe rollback. Call with only an entryId to list all available snapshots, or with both entryId and snapshotId to retrieve the full field content of that specific snapshot.
Inputs
entryIdstringrequired- The ID of the entry to retrieve snapshots for.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
snapshotIdstring- Optional snapshot ID. When provided, returns the full content of that single snapshot. When omitted, lists all available snapshots for the entry.
contentfulmcp_get_initial_contextRetrieve initial context and usage instructions for the Contentful MCP server.Read-onlyGet Initial Context
Retrieve initial context and usage instructions for the Contentful MCP server. Call this before using other tools.
Inputs
This tool takes no inputs.
contentfulmcp_get_localeRetrieve details of a specific locale including its fallback and API settings.Read-onlyGet Locale
Retrieve details of a specific locale including its fallback and API settings.
Inputs
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
localeIdstringrequired- The unique identifier of the locale (e.g. 'en-US').
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_get_orgRetrieve details of a specific Contentful organization by its ID.Read-onlyGet Org
Retrieve details of a specific Contentful organization by its ID.
Inputs
organizationIdstringrequired- The unique identifier of the Contentful organization.
contentfulmcp_get_releaseRetrieve a releaseRead-onlyGet Release
Retrieve a release
Inputs
environmentIdstringrequired- The ID of the Contentful environment
releaseIdstringrequired- The ID of the release to retrieve
spaceIdstringrequired- The ID of the Contentful space
contentfulmcp_get_release_actionRetrieve a release action by ID to check the status (created, inProgress, succeeded, failed) of a previously queued publish, unpublish, or validate operation.Read-onlyGet Release Action
Retrieve a release action by ID to check the status (created, inProgress, succeeded, failed) of a previously queued publish, unpublish, or validate operation.
Inputs
actionIdstringrequired- The ID of the release action to retrieve
environmentIdstringrequired- The ID of the Contentful environment
releaseIdstringrequired- The ID of the release the action belongs to
spaceIdstringrequired- The ID of the Contentful space
contentfulmcp_get_spaceRetrieve details of a specific Contentful space by its ID.Read-onlyGet Space
Retrieve details of a specific Contentful space by its ID.
Inputs
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_list_ai_actionsRetrieve a paginated list of AI actions defined in a Contentful environment.Read-onlyList Ai Actions
Retrieve a paginated list of AI actions defined in a Contentful environment.
Inputs
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
includenumber- Number of levels of linked entries to resolve and include in the response.
limitnumber- Maximum number of items to return per page (max 1000).
orderstring- Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
selectstring- Comma-separated list of fields to include in the response.
skipnumber- Number of items to skip for pagination.
contentfulmcp_list_assetsRetrieve a paginated list of assets in a Contentful environment with optional filters.Read-onlyList Assets
Retrieve a paginated list of assets in a Contentful environment with optional filters.
Inputs
environmentIdstringrequired- The ID of the Contentful environment
spaceIdstringrequired- The ID of the Contentful space
cursorboolean- Set to true to use cursor-based pagination instead of skip/limit. This is the correct way to fetch or process an entire collection of assets (exports, analytics, migrations), since it has no performance degradation as you page deeper. When set, pass the pageNext token from the previous response to fetch the next page (skip/total are not used in this mode).
includenumber- Include this many levels of linked entries
limitnumber- Maximum number of assets to return (max 3)
links_to_entrystring- Find assets that link to the specified entry ID
localestring- The locale to display asset fields in (e.g., "en-US", "de-DE"). Defaults to "en-US" if not specified.
orderstring- Order assets by this field
pageNextstring- Cursor token (from a previous cursor: true response) to fetch the next page of assets. Only used when cursor: true.
pagePrevstring- Cursor token (from a previous cursor: true response) to fetch the previous page of assets. Only used when cursor: true.
selectstring- Comma-separated list of fields to return
skipnumber- Skip this many assets for pagination. Use this only for random access to a bounded page (e.g. "show me page 3"). Don't use skip to iterate through an entire collection â performance degrades as the offset grows. For exhaustive traversal (exports, analytics, migrations), set cursor: true and follow pageNext instead.
contentfulmcp_list_concept_schemesRetrieve taxonomy concept schemes in a Contentful organization.Read-onlyList Concept Schemes
Retrieve taxonomy concept schemes in a Contentful organization.
Inputs
organizationIdstringrequired- The unique identifier of the Contentful organization.
querystring- Query parameters for listing concept schemes, supports either pageUrl for cursor-based pagination. Offset "skip" pagination is not supported.
contentfulmcp_list_conceptsRetrieve taxonomy concepts in a Contentful organization with optional ancestor/descendant traversal.Read-onlyList Concepts
Retrieve taxonomy concepts in a Contentful organization with optional ancestor/descendant traversal.
Inputs
organizationIdstringrequired- The unique identifier of the Contentful organization.
conceptIdstring- The unique identifier of the taxonomy concept.
getAncestorsboolean- Set to true to return ancestor concepts of the specified concept.
getDescendantsboolean- Set to true to return descendant concepts of the specified concept.
getTotalOnlyboolean- Set to true to return only the total count of concepts.
includenumber- Number of levels of linked entries to resolve and include in the response.
limitnumber- Maximum number of items to return per page (max 1000).
orderstring- Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
selectstring- Comma-separated list of fields to include in the response.
contentfulmcp_list_content_previewsList the content previews (Settings â Content Preview) configured for a space, including the URL template for each content type.Read-onlyList Content Previews
List the content previews (Settings â Content Preview) configured for a space, including the URL template for each content type. URL templates can contain secret tokens, so treat the output as sensitive.
Inputs
spaceIdstringrequired- The ID of the Contentful space
contentTypeIdstring- Only return previews that have an enabled configuration for this content type
limitnumber- Maximum number of content previews to return (default 100)
skipnumber- Skip this many content previews for pagination
contentfulmcp_list_content_typesRetrieve a paginated list of content types in a Contentful environment.Read-onlyList Content Types
Retrieve a paginated list of content types in a Contentful environment.
Inputs
environmentIdstringrequired- The ID of the Contentful environment
spaceIdstringrequired- The ID of the Contentful space
cursorboolean- Set to true to use cursor-based pagination instead of skip/limit. This is the correct way to fetch or process an entire collection of content types (exports, analytics, migrations), since it has no performance degradation as you page deeper. When set, pass the pageNext token from the previous response to fetch the next page (skip/total are not used in this mode).
includenumber- Include this many levels of linked entries
limitnumber- Maximum number of content types to return (max 10)
orderstring- Order content types by this field
pageNextstring- Cursor token (from a previous cursor: true response) to fetch the next page of content types. Only used when cursor: true.
pagePrevstring- Cursor token (from a previous cursor: true response) to fetch the previous page of content types. Only used when cursor: true.
selectstring- Comma-separated list of fields to return
skipnumber- Skip this many content types for pagination. Use this only for random access to a bounded page (e.g. "show me page 3"). Don't use skip to iterate through an entire collection â performance degrades as the offset grows. For exhaustive traversal (exports, analytics, migrations), set cursor: true and follow pageNext instead.
contentfulmcp_list_editor_interfacesRetrieve editor interface configurations for all content types in an environment.Read-onlyList Editor Interfaces
Retrieve editor interface configurations for all content types in an environment.
Inputs
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_list_environmentsRetrieve a paginated list of environments within a Contentful space.Read-onlyList Environments
Retrieve a paginated list of environments within a Contentful space.
Inputs
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
environmentIdstring- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
limitnumber- Maximum number of items to return per page (max 1000).
orderstring- Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
selectstring- Comma-separated list of fields to include in the response.
skipnumber- Number of items to skip for pagination.
contentfulmcp_list_localesRetrieve a paginated list of locales configured in a Contentful environment.Read-onlyList Locales
Retrieve a paginated list of locales configured in a Contentful environment.
Inputs
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
includenumber- Number of levels of linked entries to resolve and include in the response.
limitnumber- Maximum number of items to return per page (max 1000).
orderstring- Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
selectstring- Comma-separated list of fields to include in the response.
skipnumber- Number of items to skip for pagination.
contentfulmcp_list_orgsRetrieve a paginated list of Contentful organizations the user belongs to.Read-onlyList Orgs
Retrieve a paginated list of Contentful organizations the user belongs to.
Inputs
limitnumber- Maximum number of items to return per page (max 1000).
orderstring- Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
selectstring- Comma-separated list of fields to include in the response.
skipnumber- Number of items to skip for pagination.
contentfulmcp_list_release_actionsList release actions in a space/environment.Read-onlyList Release Actions
List release actions in a space/environment. Returns a maximum of 10 items per request. Optionally filter by release ID, action type (publish/unpublish/validate), or status.
Inputs
environmentIdstringrequired- The ID of the Contentful environment
spaceIdstringrequired- The ID of the Contentful space
actionstring- Filter by release action typeone of
publishunpublishvalidate limitnumber- Maximum number of release actions to return
releaseIdstring- Comma-separated list of release IDs to filter actions by
statusInstring- Comma-separated list of statuses to include (created, inProgress, succeeded, failed)
statusNinstring- Comma-separated list of statuses to exclude (created, inProgress, succeeded, failed)
contentfulmcp_list_releasesList releases in a space/environment.Read-onlyList Releases
List releases in a space/environment. Returns a maximum of 10 items per request. Use pageNext/pagePrev cursors to paginate through results.
Inputs
environmentIdstringrequired- The ID of the Contentful environment
spaceIdstringrequired- The ID of the Contentful space
entitiesLinkTypestring- Filter releases by the linked entity type (Entry or Asset)one of
EntryAsset entitiesSysIdInstring- Comma-separated list of entity IDs the release must contain. Requires entitiesLinkType.
limitnumber- Maximum number of releases to return (max 10)
pageNextstring- Cursor token to fetch the next page of results
pagePrevstring- Cursor token to fetch the previous page of results
statusInstring- Comma-separated list of statuses to include (active, archived)
statusNinstring- Comma-separated list of statuses to exclude (active, archived)
titleMatchstring- Full text phrase/term match on release title
contentfulmcp_list_scheduled_actionsList scheduled actions in a space/environment.Read-onlyList Scheduled Actions
List scheduled actions in a space/environment. Returns a maximum of 10 items per request. Optionally filter by release ID or status.
Inputs
environmentIdstringrequired- The ID of the Contentful environment
spaceIdstringrequired- The ID of the Contentful space
limitnumber- Maximum number of scheduled actions to return (max 10)
releaseIdstring- Filter by the release this scheduled action targets
statusInstring- Comma-separated list of statuses to include (scheduled, inProgress, succeeded, failed, canceled)
statusNinstring- Comma-separated list of statuses to exclude
contentfulmcp_list_spacesRetrieve a paginated list of Contentful spaces accessible to the authenticated user.Read-onlyList Spaces
Retrieve a paginated list of Contentful spaces accessible to the authenticated user.
Inputs
limitnumber- Maximum number of items to return per page (max 1000).
orderstring- Field to order results by (prefix with '-' for descending, e.g. '-sys.updatedAt').
selectstring- Comma-separated list of fields to include in the response.
skipnumber- Number of items to skip for pagination.
contentfulmcp_resolve_entry_referencesRecursively resolve an entry's references and return the entry plus its descendant entries and linked assets, without issuing one fetch per descendant.Read-onlyResolve Entry References
Recursively resolve an entry's references and return the entry plus its descendant entries and linked assets, without issuing one fetch per descendant. Set 'include' (1-10, default 2) to control how many levels deep to walk.
Inputs
entryIdstringrequired- The ID of the entry whose references should be resolved.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
includeinteger- How many levels of linked entries to walk (1-10, default: 2). The CMA caps this at 10.default
2
contentfulmcp_search_entriesSearch for entries in a Contentful space using flexible query parameters including field filters and full-text search.Read-onlySearch Entries
Search for entries in a Contentful space using flexible query parameters including field filters and full-text search.
Inputs
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
queryobjectrequired- Flexible search parameters supporting ANY Contentful API query parameter. Use fields.* for field searches, sys.* for system fields, and any other Contentful API parameter.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_semantic_searchFind entries by meaning using semantic (vector) search.Read-onlySemantic Search
Find entries by meaning using semantic (vector) search. Provide a descriptive natural-language query of what you're looking for; phrases resembling entry content work best. Optionally restrict to specific content types. Returns up to 10 matching entry references (unranked); use get_entry to fetch full content. Requires semantic search to be enabled for the environment.
Inputs
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
querystringrequired- Natural-language description of what you are looking for. Phrases that resemble the content of the entries you want match best; avoid questions or JSON.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentTypeIdsarray- Restrict the search to entries of these content type IDs.
contentfulmcp_append_entry_fieldAppend one or more items to an array-typed entry field (Array of Symbols, Links, or ResourceLinks) entirely server-side, deduplicating survivors before writing back only the target field/locale.WriteAppend Entry Field
Append one or more items to an array-typed entry field (Array of Symbols, Links, or ResourceLinks) entirely server-side, deduplicating survivors before writing back only the target field/locale. Prefer this over update_entry when adding items to large reference arrays, since update_entry replaces the full array and can silently lose items if the agent held a truncated read.
- Idempotent
Inputs
entryIdstringrequired- The ID of the entry to modify.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fieldIdstringrequired- The ID of the array field to append to.
localestringrequired- The locale key to target (e.g. 'en-US'). Fields are locale-keyed; you must supply the exact locale string.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
valuesarrayrequired- One or more items to append. Each item must match the element shape of the target array field: a plain string for Array of Symbols, {sys:{type:'Link', linkType:'Entry'|'Asset', id:'...'}} for Array of Links, or {sys:{type:'ResourceLink', linkType:'...', urn:'...'}} for Array of ResourceLinks.
versionnumber- Optional. The entry's sys.version as returned by get_entry. If provided, the append is rejected when the entry has changed since you read it. If omitted, the append targets the current server state without a version check.
contentfulmcp_cancel_scheduled_releaseCancel a scheduled release action.WriteCancel Scheduled Release
Cancel a scheduled release action. This is a two-phase operation: the first call (without confirm/confirmToken) returns a preview of the scheduled action and a confirmToken. To complete the cancellation, call this tool again with the same scheduledActionId, confirm: true, and the confirmToken from the preview response.
Inputs
environmentIdstringrequired- The ID of the Contentful environment
releaseIdstringrequired- The ID of the release the scheduled action belongs to
scheduledActionIdstringrequired- The ID of the scheduled action to cancel
spaceIdstringrequired- The ID of the Contentful space
confirmboolean- Set to true on the second call to actually cancel the scheduled action. Required together with confirmToken.
confirmTokenstring- Token returned by the preview call; must be supplied with confirm: true.
contentfulmcp_create_ai_actionCreate a new AI action with a prompt instruction template, model configuration, and optional test cases.WriteCreate Ai Action
Create a new AI action with a prompt instruction template, model configuration, and optional test cases.
Inputs
configurationobjectrequired- The configuration for the AI action
descriptionstringrequired- An optional description for the resource.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
instructionobjectrequired- The instruction for the AI action
namestringrequired- A human-readable name for the resource.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
testCasesarray- Test cases for the AI action
contentfulmcp_create_conceptCreate a new taxonomy concept with labels, definitions, and hierarchical relationships.WriteCreate Concept
Create a new taxonomy concept with labels, definitions, and hierarchical relationships.
Inputs
organizationIdstringrequired- The unique identifier of the Contentful organization.
prefLabelobjectrequired- The preferred label for the concept (localized)
altLabelsobject- Alternative labels for the concept (localized)
broaderarray- Links to broader concepts
conceptIdstring- The unique identifier of the taxonomy concept.
definitionobject- Definition of the concept (localized)
editorialNoteobject- Editorial note for the concept (localized)
exampleobject- Example for the concept (localized)
hiddenLabelsobject- Hidden labels for the concept (localized)
historyNoteobject- History note for the concept (localized)
notationsarray- An array of notation strings for this concept.
noteobject- General note for the concept (localized)
relatedarray- An array of related concept IDs.
scopeNoteobject- Scope note for the concept (localized)
uristring- A unique URI identifying this concept or concept scheme.
contentfulmcp_create_concept_schemeCreate a new taxonomy concept scheme for organizing related concepts.WriteCreate Concept Scheme
Create a new taxonomy concept scheme for organizing related concepts.
Inputs
organizationIdstringrequired- The unique identifier of the Contentful organization.
prefLabelobjectrequired- The preferred label for the concept scheme (localized)
conceptSchemeIdstring- The unique identifier of the taxonomy concept scheme.
definitionobject- Definition of the concept scheme (localized)
editorialNoteobject- Editorial note for the concept scheme (localized)
exampleobject- Example for the concept scheme (localized)
historyNoteobject- History note for the concept scheme (localized)
noteobject- General note for the concept scheme (localized)
scopeNoteobject- Scope note for the concept scheme (localized)
topConceptsarray- Links to top-level concepts in this scheme
uristring- A unique URI identifying this concept or concept scheme.
contentfulmcp_create_content_typeCreate a new content type with the specified fields in a Contentful environment.WriteCreate Content Type
Create a new content type with the specified fields in a Contentful environment.
Inputs
displayFieldstringrequired- The ID of the field to use as the display field for the content type.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fieldsarrayrequired- Array of field definitions for the content type
namestringrequired- A human-readable name for the resource.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentTypeIdstring- The ID of the content type. Use list_content_types to look up available IDs.
descriptionstring- An optional description for the resource.
metadataobject- No description.
contentfulmcp_create_entryCreate a new entry of a specified content type with the provided field values.WriteCreate Entry
Create a new entry of a specified content type with the provided field values.
Inputs
contentTypeIdstringrequired- The ID of the content type. Use list_content_types to look up available IDs.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fieldsobjectrequired- The field values for the new entry. Keys should be field IDs and values should be the field content.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
metadataobject- No description.
contentfulmcp_create_environmentCreate a new environment in a Contentful space, optionally cloning from an existing one.WriteCreate Environment
Create a new environment in a Contentful space, optionally cloning from an existing one.
Inputs
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
namestringrequired- A human-readable name for the resource.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
sourceEnvironmentIdstring- The ID of the environment to clone when creating the new environment.
contentfulmcp_create_localeCreate a new locale in a Contentful environment with the specified language code and settings.WriteCreate Locale
Create a new locale in a Contentful environment with the specified language code and settings.
Inputs
codestringrequired- The locale code in BCP 47 format (e.g. 'en-US', 'de-DE').
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fallbackCodestringrequired- The locale code to fall back to when content is not available in this locale.
namestringrequired- A human-readable name for the resource.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentDeliveryApiboolean- Whether this locale is enabled for the Content Delivery API.default
true contentManagementApiboolean- Whether this locale is enabled for the Content Management API.default
true defaultboolean- Whether this locale is the default locale for the environment.default
false optionalboolean- Whether this locale is optional (allows missing translations).default
false
contentfulmcp_create_releaseCreate a release with a title and a set of Entries/Assets to include in it.WriteCreate Release
Create a release with a title and a set of Entries/Assets to include in it.
Inputs
entitiesarrayrequired- The Entries and/or Assets to include in the release
environmentIdstringrequired- The ID of the Contentful environment
spaceIdstringrequired- The ID of the Contentful space
titlestringrequired- The title of the release
contentfulmcp_create_tagCreate a new tag with the specified ID, name, and visibility in a Contentful environment.WriteCreate Tag
Create a new tag with the specified ID, name, and visibility in a Contentful environment.
Inputs
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
idstringrequired- The unique identifier for the tag (must be unique within the environment).
namestringrequired- A human-readable name for the resource.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
visibilitystringrequired- Controls tag visibility. Accepted values: public, private.one of
publicprivate
contentfulmcp_create_upload_sessionCreate a short-lived upload session for staging a binary file to Contentful before creating an asset.WriteCreate Upload Session
Create a short-lived upload session for staging a binary file to Contentful before creating an asset.
Inputs
This tool takes no inputs.
contentfulmcp_disable_content_type_fieldToggle the disabled and/or omitted flags on a single content type field.WriteDisable Content Type Field
Toggle the disabled and/or omitted flags on a single content type field. Disabling hides the field from the editor UI; omitting removes it from API responses. Both flags are reversible and take effect only after the content type is published.
Inputs
contentTypeIdstringrequired- The ID of the content type containing the field.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fieldIdstringrequired- The ID of the field to update.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
disabledboolean- Set to true to disable the field in the editor UI (editors cannot edit it), false to re-enable. Takes effect once the content type is published.
omittedboolean- Set to true to omit the field from API responses, false to include it again. Takes effect once the content type is published. Prefer omit_content_type_field when only changing this flag.
contentfulmcp_invoke_ai_actionExecute an AI action with the specified variable values and return the generated result.WriteInvoke Ai Action
Execute an AI action with the specified variable values and return the generated result.
Inputs
aiActionIdstringrequired- The unique identifier of the AI action.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fieldsarrayrequired- No description.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_omit_content_type_fieldMark a single content type field as omitted (or un-omitted) from API responses.WriteOmit Content Type Field
Mark a single content type field as omitted (or un-omitted) from API responses. Reversible via the same tool with omitted=false. This is a prerequisite for delete_content_type_field: a field must be omitted in the published version before it can be deleted. Takes effect only after the content type is published.
Inputs
contentTypeIdstringrequired- The ID of the content type containing the field.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fieldIdstringrequired- The ID of the field to omit.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
omittedboolean- Whether the field should be omitted. Defaults to true. Set to false to un-omit a field.default
true
contentfulmcp_publish_releasePublish a release.WritePublish Release
Publish a release. Publishing is asynchronous: this tool returns as soon as the publish is queued (status created/inProgress), not once it completes. Use get_release_action with the returned actionId to check the outcome.
Inputs
environmentIdstringrequired- The ID of the Contentful environment
releaseIdstringrequired- The ID of the release to publish
spaceIdstringrequired- The ID of the Contentful space
contentfulmcp_schedule_publish_releaseSchedule a release to publish at a future datetime, or reschedule an existing scheduled publish action by providing scheduledActionId.WriteSchedule Publish Release
Schedule a release to publish at a future datetime, or reschedule an existing scheduled publish action by providing scheduledActionId.
Inputs
datetimestringrequired- The ISO 8601 datetime at which the release should publish
environmentIdstringrequired- The ID of the Contentful environment
releaseIdstringrequired- The ID of the release to schedule for publish
spaceIdstringrequired- The ID of the Contentful space
scheduledActionIdstring- Provide to reschedule an existing scheduled action instead of creating a new one
timezonestring- A valid IANA timezone identifier (e.g. Asia/Kolkata)
contentfulmcp_schedule_unpublish_releaseSchedule a release to unpublish at a future datetime, or reschedule an existing scheduled unpublish action by providing scheduledActionId.WriteSchedule Unpublish Release
Schedule a release to unpublish at a future datetime, or reschedule an existing scheduled unpublish action by providing scheduledActionId.
Inputs
datetimestringrequired- The ISO 8601 datetime at which the release should unpublish
environmentIdstringrequired- The ID of the Contentful environment
releaseIdstringrequired- The ID of the release to schedule for unpublish
spaceIdstringrequired- The ID of the Contentful space
scheduledActionIdstring- Provide to reschedule an existing scheduled action instead of creating a new one
timezonestring- A valid IANA timezone identifier (e.g. Asia/Kolkata)
contentfulmcp_unarchive_assetRestore one or more archived assets to make them available for editing again.WriteUnarchive Asset
Restore one or more archived assets to make them available for editing again.
- Idempotent
Inputs
assetIdstringrequired- The unique identifier of the asset.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
dryRunboolean- When true, returns a preview of the operation without executing it.
contentfulmcp_unarchive_entryRestore one or more archived entries to make them available for editing again.WriteUnarchive Entry
Restore one or more archived entries to make them available for editing again.
- Idempotent
Inputs
entryIdarrayrequired- Array of entry IDs to unarchive. Single-element array for one entry, or up to MAX_BULK_SIZE per call (default 10, max 100 â configurable via MAX_BULK_SIZE env var).
environmentIdstringrequired- The ID of the Contentful environment
spaceIdstringrequired- The ID of the Contentful space
dryRunboolean- When true, returns a preview of the operation without executing it. Still subject to MAX_BULK_SIZE â use this to confirm intent for within-limit calls.
contentfulmcp_unpublish_releaseUnpublish a release.WriteUnpublish Release
Unpublish a release. Unpublishing is asynchronous: this tool returns as soon as the unpublish is queued (status created/inProgress), not once it completes. Use get_release_action with the returned actionId to check the outcome.
Inputs
environmentIdstringrequired- The ID of the Contentful environment
releaseIdstringrequired- The ID of the release to unpublish
spaceIdstringrequired- The ID of the Contentful space
contentfulmcp_update_ai_actionUpdate an existing AI action's instruction, configuration, or test cases.WriteUpdate Ai Action
Update an existing AI action's instruction, configuration, or test cases.
Inputs
aiActionIdstringrequired- The unique identifier of the AI action.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
configurationobject- The configuration for the AI action
descriptionstring- An optional description for the resource.
instructionobject- The instruction for the AI action
namestring- A human-readable name for the resource.
testCasesarray- Test cases for the AI action
contentfulmcp_update_assetUpdate an existing asset's fields or file metadata.WriteUpdate Asset
Update an existing asset's fields or file metadata.
Inputs
assetIdstringrequired- The unique identifier of the asset.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fieldsobjectrequired- The field values to update. Keys should be field IDs and values should be the field content. Will be merged with existing fields.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
metadataobject- No description.
contentfulmcp_update_conceptUpdate an existing taxonomy concept's labels, relationships, or metadata.WriteUpdate Concept
Update an existing taxonomy concept's labels, relationships, or metadata.
Inputs
conceptIdstringrequired- The unique identifier of the taxonomy concept.
organizationIdstringrequired- The unique identifier of the Contentful organization.
versionnumberrequired- The current version number of the resource, used for optimistic concurrency control.
altLabelsobject- Alternative labels for the concept (localized)
broaderarray- Links to broader concepts
definitionobject- Definition of the concept (localized)
editorialNoteobject- Editorial note for the concept (localized)
exampleobject- Example for the concept (localized)
hiddenLabelsobject- Hidden labels for the concept (localized)
historyNoteobject- History note for the concept (localized)
notationsarray- An array of notation strings for this concept.
noteobject- General note for the concept (localized)
prefLabelobject- The preferred label for the concept (localized)
relatedarray- An array of related concept IDs.
scopeNoteobject- Scope note for the concept (localized)
uristring- A unique URI identifying this concept or concept scheme.
contentfulmcp_update_concept_schemeUpdate an existing taxonomy concept scheme's labels, definitions, or top-level concepts.WriteUpdate Concept Scheme
Update an existing taxonomy concept scheme's labels, definitions, or top-level concepts.
Inputs
conceptSchemeIdstringrequired- The unique identifier of the taxonomy concept scheme.
organizationIdstringrequired- The unique identifier of the Contentful organization.
versionnumberrequired- The current version number of the resource, used for optimistic concurrency control.
addConceptstring- The ID of the concept to add as a top-level concept in the scheme.
definitionobject- Definition of the concept scheme (localized)
editorialNoteobject- Editorial note for the concept scheme (localized)
exampleobject- Example for the concept scheme (localized)
historyNoteobject- History note for the concept scheme (localized)
noteobject- General note for the concept scheme (localized)
prefLabelobject- The preferred label for the concept scheme (localized)
scopeNoteobject- Scope note for the concept scheme (localized)
topConceptsarray- Links to top-level concepts in this scheme
uristring- A unique URI identifying this concept or concept scheme.
contentfulmcp_update_content_typeUpdate an existing content type's fields or metadata, merging with existing definitions.WriteUpdate Content Type
Update an existing content type's fields or metadata, merging with existing definitions.
Inputs
contentTypeIdstringrequired- The ID of the content type. Use list_content_types to look up available IDs.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
descriptionstring- An optional description for the resource.
displayFieldstring- The ID of the field to use as the display field for the content type.
fieldsarray- Array of field definitions for the content type. Will be merged with existing fields.
metadataobject- No description.
namestring- A human-readable name for the resource.
contentfulmcp_update_editor_interfaceUpdate the field controls, sidebar widgets, and layout for a content type editor.WriteUpdate Editor Interface
Update the field controls, sidebar widgets, and layout for a content type editor.
Inputs
contentTypeIdstringrequired- The ID of the content type. Use list_content_types to look up available IDs.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
controlsarray- Array of control definitions for fields in the content type. Each control defines which widget to use for a field.
editorLayoutarray- Editor layout configuration for organizing fields
groupControlsarray- Array of group control definitions for field groups
sidebararray- Array of sidebar widget configurations
contentfulmcp_update_entryUpdate an existing entry by merging the provided field values with the existing ones.WriteUpdate Entry
Update an existing entry by merging the provided field values with the existing ones. Requires the entry's current sys.version (obtained via get_entry) - the update is rejected if the version does not match, indicating the entry changed since it was last read.
Inputs
entryIdstringrequired- The unique identifier of the entry.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fieldsobjectrequired- The field values to update. Keys should be field IDs and values should be the field content. Will be merged with existing fields.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
versionnumberrequired- REQUIRED. The entry's sys.version as returned by get_entry. You must call get_entry first to read the current state and version. The update is rejected if this does not match the entry's current version, which means the entry changed since you read it.
metadataobject- No description.
contentfulmcp_update_localeUpdate an existing locale's settings such as name, fallback, or API access flags.WriteUpdate Locale
Update an existing locale's settings such as name, fallback, or API access flags.
Inputs
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fieldsobjectrequired- No description.
localeIdstringrequired- The unique identifier of the locale (e.g. 'en-US').
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_update_releaseUpdate a release's title and/or the Entries/Assets it contains.WriteUpdate Release
Update a release's title and/or the Entries/Assets it contains. Omitted fields keep their current value.
Inputs
environmentIdstringrequired- The ID of the Contentful environment
releaseIdstringrequired- The ID of the release to update
spaceIdstringrequired- The ID of the Contentful space
entitiesarray- The full replacement list of Entries/Assets for the release. Omit to keep the existing entities.
titlestring- The new title of the release. Omit to keep the existing title.
contentfulmcp_upload_assetUpload a new asset to Contentful from a URL or file handle.WriteUpload Asset
Upload a new asset to Contentful from a URL or file handle.
Inputs
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fileobjectrequired- The file information for the asset. Prefer file.uploadHandle for remote uploads so the client can stage raw bytes to the worker first.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
titlestringrequired- The title of the asset.
descriptionstring- An optional description for the resource.
localestring- The locale code to filter results by (e.g. 'en-US').
metadataobject- No description.
contentfulmcp_validate_releaseValidate a release, optionally against a specific downstream action (publish or unpublish).WriteValidate Release
Validate a release, optionally against a specific downstream action (publish or unpublish). Validation is asynchronous: this tool returns as soon as validation is queued (status created/inProgress), not once it completes. Use get_release_action with the returned actionId to check the outcome.
Inputs
environmentIdstringrequired- The ID of the Contentful environment
releaseIdstringrequired- The ID of the release to validate
spaceIdstringrequired- The ID of the Contentful space
actionstring- The downstream action to validate the release against. Omit to run a general validation.one of
publishunpublish
contentfulmcp_archive_assetArchive one or more assets that are no longer needed but should be preserved.DestructiveArchive Asset
Archive one or more assets that are no longer needed but should be preserved.
- Idempotent
Inputs
assetIdstringrequired- The unique identifier of the asset.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
dryRunboolean- When true, returns a preview of the operation without executing it.
contentfulmcp_archive_entryArchive one or more entries that are no longer needed but should be preserved.DestructiveArchive Entry
Archive one or more entries that are no longer needed but should be preserved.
- Idempotent
Inputs
entryIdarrayrequired- Array of entry IDs to archive. Single-element array for one entry, or up to MAX_BULK_SIZE per call (default 10, max 100 â configurable via MAX_BULK_SIZE env var).
environmentIdstringrequired- The ID of the Contentful environment
spaceIdstringrequired- The ID of the Contentful space
dryRunboolean- When true, returns a preview of the operation without executing it. Still subject to MAX_BULK_SIZE â use this to confirm intent for within-limit calls.
contentfulmcp_delete_ai_actionPermanently delete an AI action from a Contentful environment.DestructiveDelete Ai Action
Permanently delete an AI action from a Contentful environment. This is a two-phase operation: the first call (without confirm/confirmToken) returns a preview and a confirmToken; call again with confirm: true and that confirmToken to complete the deletion.
Inputs
aiActionIdstringrequired- The unique identifier of the AI action.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
confirmboolean- Set to true on the second call to actually perform the deletion. Required together with confirmToken.
confirmTokenstring- Token returned by the preview call; must be supplied with confirm: true.
contentfulmcp_delete_assetPermanently delete an asset from a Contentful environment.DestructiveDelete Asset
Permanently delete an asset from a Contentful environment. This is a two-phase operation: the first call (without confirm/confirmToken) returns a preview and a confirmToken; call again with confirm: true and that confirmToken to complete the deletion.
Inputs
assetIdstringrequired- The unique identifier of the asset.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
confirmboolean- Set to true on the second call to actually perform the deletion. Required together with confirmToken.
confirmTokenstring- Token returned by the preview call; must be supplied with confirm: true.
contentfulmcp_delete_conceptPermanently delete a taxonomy concept by its ID.DestructiveDelete Concept
Permanently delete a taxonomy concept by its ID. This is a two-phase operation: the first call (without confirm/confirmToken) returns a preview and a confirmToken; call again with confirm: true and that confirmToken to complete the deletion.
Inputs
conceptIdstringrequired- The unique identifier of the taxonomy concept.
organizationIdstringrequired- The unique identifier of the Contentful organization.
confirmboolean- Set to true on the second call to actually perform the deletion. Required together with confirmToken.
confirmTokenstring- Token returned by the preview call; must be supplied with confirm: true.
contentfulmcp_delete_concept_schemePermanently delete a taxonomy concept scheme by its ID.DestructiveDelete Concept Scheme
Permanently delete a taxonomy concept scheme by its ID. This is a two-phase operation: the first call (without confirm/confirmToken) returns a preview and a confirmToken; call again with confirm: true and that confirmToken to complete the deletion.
Inputs
conceptSchemeIdstringrequired- The unique identifier of the taxonomy concept scheme.
organizationIdstringrequired- The unique identifier of the Contentful organization.
confirmboolean- Set to true on the second call to actually perform the deletion. Required together with confirmToken.
confirmTokenstring- Token returned by the preview call; must be supplied with confirm: true.
contentfulmcp_delete_content_typePermanently delete an unpublished content type from a Contentful environment.DestructiveDelete Content Type
Permanently delete an unpublished content type from a Contentful environment. This is a two-phase operation: the first call (without confirm/confirmToken) returns a preview and a confirmToken; call again with confirm: true and that confirmToken to complete the deletion.
Inputs
contentTypeIdstringrequired- The ID of the content type. Use list_content_types to look up available IDs.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
confirmboolean- Set to true on the second call to actually perform the deletion. Required together with confirmToken.
confirmTokenstring- Token returned by the preview call; must be supplied with confirm: true.
contentfulmcp_delete_content_type_fieldPermanently mark a single content type field as deleted.DestructiveDelete Content Type Field
Permanently mark a single content type field as deleted. Destructive and irreversible once published. The field must not be required and must already be omitted in the published version of the content type (run omit_content_type_field then publish_content_type first). Use disable_content_type_field instead to temporarily hide a field.
Inputs
contentTypeIdstringrequired- The ID of the content type containing the field.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
fieldIdstringrequired- The ID of the field to delete.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_delete_entryPermanently delete an entry from a Contentful environment.DestructiveDelete Entry
Permanently delete an entry from a Contentful environment. This is a two-phase operation: the first call (without confirm/confirmToken) returns a preview and a confirmToken; call again with confirm: true and that confirmToken to complete the deletion.
Inputs
entryIdstringrequired- The unique identifier of the entry.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
confirmboolean- Set to true on the second call to actually perform the deletion. Required together with confirmToken.
confirmTokenstring- Token returned by the preview call; must be supplied with confirm: true.
contentfulmcp_delete_environmentPermanently delete an environment from a Contentful space.DestructiveDelete Environment
Permanently delete an environment from a Contentful space. This is a two-phase operation: the first call (without confirm/confirmToken) returns a preview and a confirmToken; call again with confirm: true and that confirmToken to complete the deletion.
Inputs
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
confirmboolean- Set to true on the second call to actually perform the deletion. Required together with confirmToken.
confirmTokenstring- Token returned by the preview call; must be supplied with confirm: true.
contentfulmcp_delete_localePermanently delete a locale from a Contentful environment.DestructiveDelete Locale
Permanently delete a locale from a Contentful environment. This is a two-phase operation: the first call (without confirm/confirmToken) returns a preview and a confirmToken; call again with confirm: true and that confirmToken to complete the deletion.
Inputs
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
localeIdstringrequired- The unique identifier of the locale (e.g. 'en-US').
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
confirmboolean- Set to true on the second call to actually perform the deletion. Required together with confirmToken.
confirmTokenstring- Token returned by the preview call; must be supplied with confirm: true.
contentfulmcp_publish_ai_actionPublish an AI action to make it available for use in the Contentful editor.DestructivePublish Ai Action
Publish an AI action to make it available for use in the Contentful editor.
- Idempotent
Inputs
aiActionIdstringrequired- The unique identifier of the AI action.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_publish_assetPublish one or more assets to make them available via the Content Delivery API.DestructivePublish Asset
Publish one or more assets to make them available via the Content Delivery API.
- Idempotent
Inputs
assetIdstringrequired- The unique identifier of the asset.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
dryRunboolean- When true, returns a preview of the operation without executing it.
contentfulmcp_publish_content_typePublish a content type to make it available for creating entries.DestructivePublish Content Type
Publish a content type to make it available for creating entries.
- Idempotent
Inputs
contentTypeIdstringrequired- The ID of the content type. Use list_content_types to look up available IDs.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_publish_entryPublish one or more entries to make them available via the Content Delivery API.DestructivePublish Entry
Publish one or more entries to make them available via the Content Delivery API.
- Idempotent
Inputs
entryIdarrayrequired- Array of entry IDs to publish. Single-element array for one entry, or up to MAX_BULK_SIZE per call (default 10, max 100 â configurable via MAX_BULK_SIZE env var).
environmentIdstringrequired- The ID of the Contentful environment
spaceIdstringrequired- The ID of the Contentful space
dryRunboolean- When true, returns a preview of the operation without executing it. Still subject to MAX_BULK_SIZE â use this to confirm intent for within-limit calls.
contentfulmcp_unpublish_ai_actionUnpublish an AI action, removing it from the available actions in the editor.DestructiveUnpublish Ai Action
Unpublish an AI action, removing it from the available actions in the editor.
- Idempotent
Inputs
aiActionIdstringrequired- The unique identifier of the AI action.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_unpublish_assetUnpublish one or more assets, removing them from the Content Delivery API.DestructiveUnpublish Asset
Unpublish one or more assets, removing them from the Content Delivery API.
- Idempotent
Inputs
assetIdstringrequired- The unique identifier of the asset.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
dryRunboolean- When true, returns a preview of the operation without executing it.
contentfulmcp_unpublish_content_typeUnpublish a content type so it can no longer be used to create new entries.DestructiveUnpublish Content Type
Unpublish a content type so it can no longer be used to create new entries.
- Idempotent
Inputs
contentTypeIdstringrequired- The ID of the content type. Use list_content_types to look up available IDs.
environmentIdstringrequired- The Contentful environment ID (e.g. 'master', 'staging'). Find it in Settings > Environments.
spaceIdstringrequired- The unique identifier of the Contentful space. Find it in your Contentful dashboard under Settings > General.
contentfulmcp_unpublish_entryUnpublish one or more entries, removing them from the Content Delivery API.DestructiveUnpublish Entry
Unpublish one or more entries, removing them from the Content Delivery API.
- Idempotent
Inputs
entryIdarrayrequired- Array of entry IDs to unpublish. Single-element array for one entry, or up to MAX_BULK_SIZE per call (default 10, max 100 â configurable via MAX_BULK_SIZE env var).
environmentIdstringrequired- The ID of the Contentful environment
spaceIdstringrequired- The ID of the Contentful space
dryRunboolean- When true, returns a preview of the operation without executing it. Still subject to MAX_BULK_SIZE â use this to confirm intent for within-limit calls.
No tools match.
