> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Contentful

**Authentication:** OAuth or personal access token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* List every entry in the `Blog Post` content type published in the last 30 days.
* Update the `Hero` entry on the homepage to use the new Q2 banner image.
* Find unpublished drafts older than 60 days for review.

## Available Tools

#### list\_assets

List assets in a Contentful environment. Optionally filter by MIME type group.

#### get\_asset

Get a Contentful asset by ID.

#### create\_asset

Create a new asset in Contentful. Must be processed and published after creation.

#### update\_asset

Update a Contentful asset. Requires current version for optimistic locking.

#### delete\_asset

Delete a Contentful asset. Must be unpublished first.

#### publish\_asset

Publish a Contentful asset to make it available via the Content Delivery API.

#### unpublish\_asset

Unpublish a Contentful asset to remove it from the Content Delivery API.

#### process\_asset

Process a Contentful asset for a specific locale. Downloads and stores the file.

#### list\_content\_types

List all content types in a Contentful environment.

#### get\_content\_type

Get a Contentful content type by ID.

#### create\_content\_type

Create a new content type in Contentful. Must be published before entries can be created.

#### update\_content\_type

Update a Contentful content type. Requires current version for optimistic locking.

#### delete\_content\_type

Delete a Contentful content type. Must be unpublished first and have no entries.

#### publish\_content\_type

Publish a Contentful content type. Required before entries can be created.

#### unpublish\_content\_type

Unpublish a Contentful content type. All entries must be deleted first.

#### list\_entries

List entries in a Contentful environment. Filter by content type or query parameters.

#### get\_entry

Get a Contentful entry by ID.

#### create\_entry

Create a new entry in Contentful. Specify content type and field values by locale.

#### update\_entry

Update a Contentful entry. Requires current version for optimistic locking.

#### delete\_entry

Delete a Contentful entry. Must be unpublished first.

#### publish\_entry

Publish a Contentful entry to make it available via the Content Delivery API.

#### unpublish\_entry

Unpublish a Contentful entry to remove it from the Content Delivery API.

#### archive\_entry

Archive a Contentful entry. Must be unpublished first.

#### unarchive\_entry

Unarchive a Contentful entry to make it editable again.

#### list\_environments

List all environments in a Contentful space.

#### get\_environment

Get a Contentful environment by ID.

#### create\_environment

Create a new Contentful environment. Optionally clone from an existing environment.

#### delete\_environment

Delete a Contentful environment. WARNING: Cannot delete the master environment.

#### list\_locales

List all locales in a Contentful environment.

#### get\_locale

Get a Contentful locale by ID.

#### create\_locale

Create a new locale in a Contentful environment.

#### update\_locale

Update a Contentful locale. Requires current version for optimistic locking.

#### delete\_locale

Delete a Contentful locale. Cannot delete the default locale.

#### list\_spaces

List all Contentful spaces accessible to the authenticated user.

#### get\_space

Get a Contentful space by ID.

#### create\_space

Create a new Contentful space. Requires organization\_id for paid accounts.

#### update\_space

Update a Contentful space name. Requires current version for optimistic locking.

#### delete\_space

Delete a Contentful space. WARNING: This permanently deletes the space and all its content.

#### list\_webhooks

List all webhooks in a Contentful space.

#### get\_webhook

Get a Contentful webhook by ID.

#### create\_webhook

Create a new webhook in a Contentful space to receive notifications for content events.

#### update\_webhook

Update a Contentful webhook. Requires current version for optimistic locking.

#### delete\_webhook

Delete a Contentful webhook.

#### get\_webhook\_calls

Get recent call details for a Contentful webhook.

#### get\_webhook\_health

Get health status for a Contentful webhook.