Connect AI agents to the Contentful MCP server

Vendor MCP

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 70 tools.

Tools: 70
What they doRead · write · destructive: 27 · 24 · 1927 read24 write19 destructive
Users sign in with: OAuth
OAuth app: Scalekit's or your own

Setup

Install the SDK
- Node.js
- Python
Terminal window
npm install @scalekit-sdk/node dotenv
Terminal window
pip install scalekit-sdk-python python-dotenv
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>
```
Create the Contentful MCP connection
In AgentKit > Connections, create a Contentful MCP connection. The name you give it is the connection_name your 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

Node.js
Python

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3
import { createInterface } from 'node:readline/promises'
4

5
const scalekit = new ScalekitClient(
6
  process.env.SCALEKIT_ENVIRONMENT_URL,
7
  process.env.SCALEKIT_CLIENT_ID,
8
  process.env.SCALEKIT_CLIENT_SECRET,
9
)
10
const actions = scalekit.actions
11

12
const connector = 'contentfulmcp'
13
const identifier = 'user_123'
14

15
// Generate an authorization link for the user
16
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
17
console.log('Authorize Contentful MCP:', link)
18
const rl = createInterface({ input: process.stdin, output: process.stdout })
19
await rl.question('Press Enter after authorizing...')
20
rl.close()
21

22
// Make your first call
23
const result = await actions.executeTool({
24
  connector,
25
  identifier,
26
  toolName: 'contentfulmcp_get_initial_context',
27
  toolInput: {},
28
})
29
console.log(result)

npx tsx quickstart.mts

1
import os
2
from scalekit import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "contentfulmcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Contentful MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="contentfulmcp_get_initial_context",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

python quickstart.py

Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool

Try in Playground Request a tool

contentfulmcp_get_ai_actionRetrieve details of a specific AI action including its instruction template and configuration.Read-only
Get 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-only
Get 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-only
Get 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-only
Get 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-only
Get 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-only
Get 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-only
Get 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-only
Get 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_snapshotRetrieve version history (snapshots) of an entry for safe rollback.Read-only
Get 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-only
Get 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-only
Get 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-only
Get Org
Retrieve details of a specific Contentful organization by its ID.
Inputs
organizationIdstringrequired
The unique identifier of the Contentful organization.
contentfulmcp_get_spaceRetrieve details of a specific Contentful space by its ID.Read-only
Get 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-only
List 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-only
List Assets
Retrieve a paginated list of assets in a Contentful environment with optional filters.
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).
links_to_entrystring
Return only assets or entries that link to the specified entry ID.
localestring
The locale code to filter results by (e.g. 'en-US').
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_concept_schemesRetrieve taxonomy concept schemes in a Contentful organization.Read-only
List 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-only
List 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_typesRetrieve a paginated list of content types in a Contentful environment.Read-only
List Content Types
Retrieve a paginated list of content types 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_editor_interfacesRetrieve editor interface configurations for all content types in an environment.Read-only
List 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-only
List 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-only
List 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-only
List 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_spacesRetrieve a paginated list of Contentful spaces accessible to the authenticated user.Read-only
List 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_list_tagsRetrieve a paginated list of tags in a Contentful environment.Read-only
List Tags
Retrieve a paginated list of tags 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.
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-only
Resolve 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-only
Search 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-only
Semantic 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.Write
Append 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_create_ai_actionCreate a new AI action with a prompt instruction template, model configuration, and optional test cases.Write
Create 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.Write
Create 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.Write
Create 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.Write
Create 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.Write
Create 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.Write
Create 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.Write
Create 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_tagCreate a new tag with the specified ID, name, and visibility in a Contentful environment.Write
Create 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.Write
Create 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.Write
Disable 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.Write
Invoke 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.Write
Omit 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_unarchive_assetRestore one or more archived assets to make them available for editing again.Write
Unarchive 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.Write
Unarchive Entry
Restore one or more archived entries to make them available for editing again.
- Idempotent
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.
dryRunboolean
When true, returns a preview of the operation without executing it.
contentfulmcp_update_ai_actionUpdate an existing AI action's instruction, configuration, or test cases.Write
Update 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.Write
Update 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.Write
Update 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.Write
Update 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.Write
Update 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.Write
Update 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.Write
Update 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.Write
Update 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_upload_assetUpload a new asset to Contentful from a URL or file handle.Write
Upload 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_archive_assetArchive one or more assets that are no longer needed but should be preserved.Destructive
Archive 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.Destructive
Archive Entry
Archive one or more entries that are no longer needed but should be preserved.
- Idempotent
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.
dryRunboolean
When true, returns a preview of the operation without executing it.
contentfulmcp_delete_ai_actionPermanently delete an AI action from a Contentful environment.Destructive
Delete 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.Destructive
Delete 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.Destructive
Delete 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.Destructive
Delete 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.Destructive
Delete 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.Destructive
Delete 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.Destructive
Delete 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.Destructive
Delete 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.Destructive
Delete 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.Destructive
Publish 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.Destructive
Publish 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.Destructive
Publish 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.Destructive
Publish Entry
Publish one or more entries to make them available via the Content Delivery API.
- Idempotent
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.
dryRunboolean
When true, returns a preview of the operation without executing it.
contentfulmcp_unpublish_ai_actionUnpublish an AI action, removing it from the available actions in the editor.Destructive
Unpublish 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.Destructive
Unpublish 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.Destructive
Unpublish 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.Destructive
Unpublish Entry
Unpublish one or more entries, removing them from the Content Delivery API.
- Idempotent
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.
dryRunboolean
When true, returns a preview of the operation without executing it.

Setup

Install the SDK

Set your credentials

Create the Contentful MCP connection

Authorize a user and make your first call

Tools

Call it

Returns

Get Ai Action

Inputs

Get Ai Action Invocation

Inputs

Get Asset

Inputs

Get Concept

Inputs

Get Concept Scheme

Inputs

Get Content Type

Inputs

Get Editor Interface

Inputs

Get Entry

Inputs

Get Entry Snapshot

Inputs

Get Initial Context

Inputs

Get Locale

Inputs

Get Org

Inputs

Get Space

Inputs

List Ai Actions

Inputs

List Assets

Inputs

List Concept Schemes

Inputs

List Concepts

Inputs

List Content Types

Inputs

List Editor Interfaces

Inputs

List Environments

Inputs

List Locales

Inputs

List Orgs

Inputs

List Spaces

Inputs

List Tags

Inputs

Resolve Entry References

Inputs

Search Entries

Inputs

Semantic Search

Inputs

Append Entry Field

Inputs

Create Ai Action

Inputs

Create Concept

Inputs

Create Concept Scheme

Inputs

Create Content Type

Inputs

Create Entry

Inputs

Create Environment

Inputs

Create Locale

Inputs

Create Tag

Inputs