Contentful MCP Server
for AI Agents

Create a new asset in the specified space's master environment. Fires the `ContentManagement.Asset.create` webhook. Server generates the asset ID; response `sys.version` is 1. Asset is NOT yet processed or published — call `process_asset` then `publish_asset` to complete the workflow.

Publish an asset so it becomes available on the Content Delivery API. Fires the `ContentManagement.Asset.publish` webhook. Asset MUST have been processed (via `process_asset`) for every locale that has file data — otherwise Contentful returns 422 ValidationFailed.

Retrieve a single asset by its ID from the specified space's master environment. Use this to fetch the current `sys.version` before any update/delete/publish/unpublish/process call.

Update an existing asset by ID. Fires the `ContentManagement.Asset.save` webhook. Requires X-Contentful-Version optimistic-lock header — Contentful returns 409 on version mismatch.

Permanently delete an asset by ID. Fires the `ContentManagement.Asset.delete` webhook. Asset MUST be unpublished first — Contentful rejects deletion of a currently-published asset with a 400.

Create a content type with a caller-supplied ID (Contentful uses PUT for upsert-by-ID — there is no POST endpoint). Fires the `ContentManagement.ContentType.create` webhook. Content types must be activated (via `activate_content_type`) before entries can be created against them.

Retrieve a single content type by its ID from the specified space's master environment. Use this to fetch the current `sys.version` before any update/delete/publish/unpublish call.

Update an existing content type. Fires the `ContentManagement.ContentType.save` webhook. Requires X-Contentful-Version optimistic-lock header — Contentful returns 409 on version mismatch. After update, you typically re-activate via `activate_content_type` for schema changes to appear on the CDA.

Permanently delete a content type. Fires the `ContentManagement.ContentType.delete` webhook. Content type MUST be unpublished first AND have no entries associated — Contentful rejects deletion otherwise with a 400.

Create a new entry of the given content type in the specified space's master environment. Fires the `ContentManagement.Entry.create` webhook. Server generates the entry ID; response `sys.version` is 1.

Publish an entry so it becomes available on the Content Delivery API. Fires the `ContentManagement.Entry.publish` webhook. Requires X-Contentful-Version optimistic-lock header.

Retrieve a single entry by its ID from the specified space's master environment. Use this to fetch the current `sys.version` before any update/delete/publish/unpublish call.

Update an existing entry by ID. Fires the `ContentManagement.Entry.save` webhook. Requires the X-Contentful-Version optimistic-lock header — Contentful returns 409 on version mismatch.

Permanently delete an entry by ID. Fires the `ContentManagement.Entry.delete` webhook. Entry MUST be unpublished first — Contentful rejects deletion of a currently-published entry with a 400.

List all organizations the authenticated user has access to.

Get details for a specific organization (admin/owner only).

Update an organization's properties (admin/owner only).

List all members of an organization.

Retrieve a single organization membership.

Update an organization member's role.

Remove a user from the organization.

Invite a user to join the organization. The invitee receives an email with an acceptance link.

Retrieve a pending or accepted organization invitation by its identifier.

Create a new personal access token for the authenticated user.

List the authenticated user's personal access tokens.

Retrieve metadata for a specific personal access token.

Create a custom role in a space.

List all roles in a space.

Retrieve a single role by ID.

Update an existing role.

Permanently delete a role.

Grant an existing organization member access to a space (cannot invite net-new users).

List space-membership records for a space (each item carries the user link, admin flag, and role assignments).

Retrieve a single space membership by ID.

Update a space membership's roles or admin status.

Remove a user from a space.

List combined direct and team-derived members of a space.

Retrieve a single space member's combined direct and team-derived access.

Create a new space in an organization. Requires the organization to have an available space-creation license; otherwise the provider returns 422 LicenseNotFoundError.

List all spaces accessible to the authenticated user.

Retrieve a single space by ID.

Update a space's name.

Permanently delete a space and all of its resources.

Get add-on allocations for a space. Requires the space add-ons feature on the account's plan; non-eligible accounts return 404 Resource not found.

Update add-on allocations for a space. Requires the space add-ons feature on the account's plan; non-eligible accounts return 404 Resource not found.

Create a new team in an organization.

Retrieve a single team by ID.

Update a team's name and description.

Delete a team from an organization.

Add an organization member to a team.

Retrieve a single team membership by ID.

Remove a member from a team.

Grant a team access to a space.

Retrieve a single team space membership by ID.

Update a team's access to a space.

Revoke a team's access to a space.

List User objects (name, email, avatar, activated state) for everyone with access to a Contentful space. If you need role or admin assignments per user, use list_space_memberships instead.

Get a single user with access to a Contentful space.

List all users in a Contentful organization.

Get a single user in a Contentful organization.