Kontent.ai

Kontent.ai MCP Server connects your Kontent.ai projects with AI tools by implementing the Model Context Protocol. It lets AI models understand your content structure and perform operations through natural language instructions, enabling rapid prototyping, exploration, and automation of content models and workflows.

How to use

You use the MCP server by starting it as a local service or connecting to it through an HTTP transport, then configuring your MCP client (such as an editor or AI tool) to talk to the server. You can drive content model exploration, patching, item and variant management, and semantic searches by issuing natural language-guided instructions through compatible clients. Ensure you have your Kontent.ai environment ready and provide the necessary credentials so the client can authenticate and request operations through the MCP server.

How to install

Prerequisites you should have before installing are a supported runtime environment, Git, and network access. You will also need a Kontent.ai account, a project, a Management API key, and the environment ID for your Kontent.ai environment.

Step by step you can follow to set up the MCP server locally and start using it with the provided transports:

Clone the repository, install dependencies, and build the project.

Start the server using the STDIO transport or the HTTP transport as described in the transport options.

Additional setup and configuration

You can run the MCP server in single-tenant mode with environment variables or in multi-tenant mode for concurrent environments via the HTTP transport. The single-tenant mode requires you to set API credentials and environment identifiers in your environment or a .env file. The multi-tenant mode accepts requests for different environments by path and bearer authentication.

Configuration details include the required environment values for a standard local setup and how to structure transport connections for tools like VS Code, Claude Desktop, and Claude Code.

Transport options details

Two transport options are supported: STDIO for local usage and Streamable HTTP for remote access. The STDIO transport runs in-process and is configured via command line invocations. The Streamable HTTP transport exposes the MCP server over HTTP so clients can connect remotely.

Security and best practices

Protect your Management API key and environment ID. When using multi-tenant mode, ensure Bearer tokens are transmitted securely and that your client configurations only expose the necessary endpoints and headers.

Troubleshooting and tips

If you encounter connection issues, verify that the server is running, the transport endpoint is accessible, and your API credentials are correct. Use the MCP inspector tool for debugging and to explore available tools and endpoints.

Notes

When using the server, you may choose between starting with the STDIO transport for local development or using the HTTP transport for multi-environment setups. Always ensure your environment variables or configuration provide the necessary credentials and identifiers.

Available tools

get-patch-guide

REQUIRED before any patch operation. Retrieve the patch operations guide for Kontent.ai Management API by entity type.

get-type-mapi

Get Kontent.ai content type by internal ID from Management API.

list-content-types-mapi

List all Kontent.ai content types from Management API.

add-content-type-mapi

Add a new Kontent.ai content type via Management API.

patch-content-type-mapi

Update an existing Kontent.ai content type by codename using patch operations (move, addInto, remove, replace).

delete-content-type-mapi

Delete a Kontent.ai content type by codename.

get-type-snippet-mapi

Get Kontent.ai content type snippet by internal ID from Management API.

list-content-type-snippets-mapi

List all Kontent.ai content type snippets from Management API.

add-content-type-snippet-mapi

Add a new Kontent.ai content type snippet via Management API.

patch-type-snippet-mapi

Update an existing Kontent.ai content type snippet by internal ID using patch operations (move, addInto, remove, replace).

delete-type-snippet-mapi

Delete a Kontent.ai content type snippet by codename.

get-taxonomy-group-mapi

Get Kontent.ai taxonomy group by internal ID from Management API.

list-taxonomy-groups-mapi

List all Kontent.ai taxonomy groups from Management API.

add-taxonomy-group-mapi

Add a new Kontent.ai taxonomy group via Management API.

patch-taxonomy-group-mapi

Update Kontent.ai taxonomy group using patch operations (addInto, move, remove, replace) via Management API.

delete-taxonomy-group-mapi

Delete Kontent.ai taxonomy group by internal ID.

get-item-mapi

Get Kontent.ai item by internal ID from Management API.

get-latest-variant-mapi

Get latest version of Kontent.ai language variant from Management API.

get-published-variant-mapi

Get published version of Kontent.ai language variant from Management API.

list-variants-item-mapi

List all Kontent.ai language variants of a content item from Management API.

list-variants-collection-mapi

List Kontent.ai language variants by collection from Management API (paginated).

list-variants-type-mapi

List Kontent.ai language variants by content type from Management API (paginated).

list-variants-components-type-mapi

List Kontent.ai language variants containing components of a specific content type from Management API (paginated).

list-variants-space-mapi

List Kontent.ai language variants by space from Management API (paginated).

add-content-item-mapi

Add new Kontent.ai content item via Management API. Creates the content item structure but does not add content to language variants.

update-content-item-mapi

Update existing Kontent.ai content item by internal ID via Management API. The content item must already exist.

delete-content-item-mapi

Delete Kontent.ai content item by internal ID from Management API.

upsert-language-variant-mapi

Create or update Kontent.ai language variant of a content item via Management API. Only provided elements are modified when updating.

create-variant-version-mapi

Create a new version of a Kontent.ai language variant via Management API.

delete-language-variant-mapi

Delete Kontent.ai language variant from Management API.

filter-variants-mapi

Filter Kontent.ai language variants of content items using Management API with support for exact keyword matching and complex filtering.

search-variants-mapi

AI-powered semantic search for content by meaning in a specific language variant.

get-asset-mapi

Get a specific Kontent.ai asset by internal ID from Management API.

list-assets-mapi

Get all Kontent.ai assets from Management API.

update-asset-mapi

Update Kontent.ai asset by internal ID.

list-asset-folders-mapi

List all Kontent.ai asset folders.

patch-asset-folders-mapi

Modify Kontent.ai asset folders using patch operations (addInto, rename, remove).

list-languages-mapi

Get all Kontent.ai languages from Management API.

add-language-mapi

Add new Kontent.ai language via Management API.

patch-language-mapi

Update Kontent.ai language using replace operations via Management API.

list-collections-mapi

Get all Kontent.ai collections from Management API.

patch-collections-mapi

Update Kontent.ai collections using patch operations.

list-spaces-mapi

Get all Kontent.ai spaces from Management API.

add-space-mapi

Add Kontent.ai space to environment.

patch-space-mapi

Patch Kontent.ai space using replace operations.

delete-space-mapi

Delete Kontent.ai space.

list-roles-mapi

Get all Kontent.ai roles from Management API.

list-workflows-mapi

Get all Kontent.ai workflows from Management API.

add-workflow-mapi

Create a new Kontent.ai workflow via Management API.

update-workflow-mapi

Update an existing Kontent.ai workflow by ID via Management API.

delete-workflow-mapi

Delete a Kontent.ai workflow by ID via Management API.

change-variant-workflow-step-mapi

Change the workflow step of a language variant.

publish-variant-mapi

Publish or schedule publication of a language variant.

unpublish-variant-mapi

Unpublish or schedule unpublishing of a language variant.