MCP.so
Sign In

Kontent.ai MCP Server

@kontent-ai

About Kontent.ai MCP Server

The Official Kontent.ai MCP server. Connect your AI with Kontent.ai.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "kontent-ai-stdio": {
      "command": "npx",
      "args": [
        "@kontent-ai/mcp-server@latest",
        "stdio"
      ],
      "env": {
        "KONTENT_API_KEY": "<management-api-key>",
        "KONTENT_ENVIRONMENT_ID": "<environment-id>"
      }
    }
  }
}

Tools

53

Create (add) new Kontent.ai content item (creates the container only, use create-content-item-variant to add language versions/translations). Items are language-neutral and hold content item variants for each language.

Build (upsert) a new Kontent.ai content type snippet from scratch — a reusable set of elements you can include in multiple content types. Use this to add a snippet that does not yet exist.

Build a new Kontent.ai content type (schema/model) from scratch — define its elements, validation rules, and content groups. Use this to add a content type that does not yet exist.

Create (add) and configure new Kontent.ai language locale for translations and localization. Languages are always created as active.

Create (add) new Kontent.ai space for managing a website or channel. Spaces provide channel-specific context with their own domain and preview URLs.

Create (add) new Kontent.ai taxonomy group for content categorization. Taxonomy groups contain hierarchical terms (categories/tags) for classifying content.

Create (add) new Kontent.ai workflow with custom steps. Workflows define content lifecycle stages for review and approval.

Bulk/batch retrieve full details and content for multiple (2 or more) Kontent.ai content item variants by item and language reference pairs. Fetch full content for several items whose IDs were found via other tools.

Cancel scheduled publishing of Kontent.ai content item variant (language version/translation). Reverts variant back to previous workflow step, enabling further edits.

Move Kontent.ai content item variant (language version/translation) to a different workflow step. Transition content between lifecycle stages (e.g., draft to review, review to approved/published, or archive).

Create Kontent.ai content item variant — translate and localize content into a specific language. Adds a new language version (translation) for a content item. Send only the elements you want to set (omitted ones initialize with default value). Element values must fulfill the content type definition.

Create new draft version of a published Kontent.ai content item variant (language version/translation). Required before editing published content.

Delete (remove) Kontent.ai content item and all its content item variants.

Delete (remove) Kontent.ai content type snippet by ID. Removes the reusable shared element set definition.

Delete (remove) Kontent.ai content type by ID. Removes the schema/model definition.

Delete (remove) Kontent.ai content item variant (language version/translation). Removes translated content for a specific language from an item.

Delete (remove) Kontent.ai space by ID. Removes the channel/website context.

Delete (remove) Kontent.ai taxonomy group by ID. Removes the category/tag group and all its terms.

Delete (remove) Kontent.ai workflow. Cannot delete the default workflow.

Retrieve Kontent.ai asset by ID. Assets are digital media files (images, videos, documents, PDFs) standalone, or referenced from other entities, typically content item variants.

Retrieve (fetch) a single Kontent.ai content item by ID — returns its details: name, codename, and content type. Items are language-neutral containers; one item has multiple content item variants (translations). Do NOT call this in a loop to identify an item among several candidates by name — narrow down first with list-content-item-variants's search_phrase filter.

Retrieve Kontent.ai content type snippet. Snippets are reusable, shared sets of elements included across multiple content types.

Retrieve (fetch) a single Kontent.ai content type by ID — its schema/model definition. Content types define content structure: elements, field validation rules, and content groups.

Get all Kontent.ai content item translations — every language version (variant) of a specific content item. Returns each language's current version (draft if one exists, otherwise the last one saved), which may differ from the version currently live on the Delivery API. Retrieve translated content across all languages to examine details of a specific item in translation scenarios, rather than to search for items — for finding or disambiguating among candidates, use list-content-item-variants's search_phrase filter.

Retrieve a single Kontent.ai content item variant (language version/translation) by item and language ID. Returns the current version — draft if one exists, otherwise published.

REQUIRED before any patch operation. Returns operation constraints and caveats not visible in the patch tool schemas — including unsupported operations, conditions under which operations fail, and ordering rules. Call this before constructing any patch.

Retrieve the published (live) version and details of a Kontent.ai content item variant, exactly as served on the Delivery API right now, even when a newer draft version exists.

Retrieve Kontent.ai taxonomy group by ID or codename. Taxonomy groups provide a classification hierarchy of tree-structured terms (categories/tags) that can be nested to any depth for content categorization.

List all Kontent.ai asset folders. Folders organize digital media files (images, videos, documents) into a hierarchical directory structure.

List all Kontent.ai assets (paginated). Assets are digital media files (images, videos, documents, PDFs) referenced in content items.

List all Kontent.ai collections. Collections organize and group content items by team, brand, or project for access control and content separation.

List all Kontent.ai content type snippets (paginated). Retrieve every content type snippet — reusable, shared sets of elements included across multiple content types.

List all Kontent.ai content types (paginated). Retrieve every content type (schema/model) definition. Get an overview of all content type models, their elements, field validation rules, and content groups.

List, find, filter Kontent.ai content items with content item variants (language versions/translations), returning lightweight item ID + language ID references for further lookup. Filter by content item content type, collection, space, workflow step, taxonomy, contained content component content type, or publishing state. Search items and variants by EXACT keyword matching (terms use OR). Use search-content-item-variants when you know what content is *about* (topic, theme) rather than its name or identity.

List all Kontent.ai languages (paginated), including inactive ones - check is_active property. Languages define available locales for translations and localization; each can have fallback language for content inheritance.

List all Kontent.ai roles. Roles define user permissions and access control within the environment.

List all Kontent.ai spaces. Spaces provide channel-specific site configuration for managing multiple websites/channels. Each space has its own domain and preview URLs; collections connect to spaces to organize content per channel.

List all Kontent.ai taxonomy groups (paginated). Taxonomy groups contain hierarchical tree-structured terms (categories/tags) that can be nested to any depth for content categorization and classification.

List all Kontent.ai workflows and their steps. Workflows define content lifecycle stages: draft, review, approval, published, scheduled, archived.

Update (modify/edit) Kontent.ai asset folders using patch operations. Always call get-patch-guide(entityType='asset-folder') first — it documents constraints not visible in this schema that the API enforces.

Update (modify/edit) Kontent.ai collections using patch operations. Always call get-patch-guide(entityType='collection') first — it documents constraints not visible in this schema that the API enforces.

Update (modify/edit) Kontent.ai content type snippet using patch operations (add, move, remove, replace elements/fields). Add new fields to an existing snippet, or rearrange or remove existing elements. Always call get-patch-guide(entityType='snippet') first for operations reference.

Update (modify/edit) Kontent.ai content type schema using patch operations (add, move, remove, replace elements/fields). Add new fields, rearrange or remove existing elements. Always call get-patch-guide(entityType='content-type') first for operations reference.

Update (modify/edit) Kontent.ai language properties using replace patch operations. Always call get-patch-guide(entityType='language') first — it documents constraints and available properties not visible in this schema.

Update (modify/edit) Kontent.ai space properties using replace patch operations. Always call get-patch-guide(entityType='space') first for operations reference.

Update (modify/edit) and organize Kontent.ai taxonomy group terms using patch operations. Always call get-patch-guide(entityType='taxonomy') first — it documents ordering rules and constraints not visible in this schema.

Publish or schedule publishing of Kontent.ai content item variant (language version/translation). Transitions content to the published workflow step, making it live. For scheduling, verify current UTC time before using scheduledTo.

AI semantic search for Kontent.ai content items with content item variants (language versions/translations) by topic, theme, or meaning. Use when you know what content is *about* — not when looking for an item by name or title; use list-content-item-variants for that. Returns lightweight references, top 50 results max. This feature may be unavailable.

Unpublish or schedule unpublishing of Kontent.ai content item variant (language version/translation). Takes content offline and archives it. For scheduling, verify current UTC time before using scheduledTo.

Update (edit) Kontent.ai asset metadata by ID. Modify asset title, descriptions, or taxonomy-based properties.

Update (edit/rename) Kontent.ai content item metadata: name, collection.

Update Kontent.ai content item variant (language version/translation). Send only the elements you want to change — omitted elements are left untouched on the existing variant. Values must fulfill validation rules defined in the content type.

Update (edit) Kontent.ai workflow steps, transitions, and settings. Modify content lifecycle stages.

Overview

What is Kontent.ai MCP Server?

Kontent.ai MCP Server implements the Model Context Protocol to connect your Kontent.ai projects with AI tools like Claude, Cursor, and VS Code. It enables AI models to understand your content structure and perform operations through natural language instructions.

How to use Kontent.ai MCP Server?

Run the server with npx using the desired transport: npx @kontent-ai/mcp-server@latest stdio for local single‑tenant use, or npx @kontent-ai/mcp-server@latest shttp for a remote multi‑tenant server. For STDIO, configure credentials via environment variables (KONTENT_API_KEY, KONTENT_ENVIRONMENT_ID). For Streamable HTTP, pass the environment ID as a URL path parameter and the API key as a Bearer token.

Key features of Kontent.ai MCP Server

  • Rapid prototyping: transform diagrams into live content models in seconds
  • Data visualization: visualize your content model in any format
  • Manage content types, snippets, taxonomies, and languages
  • Create, update, and publish content items with variants
  • Manage content lifecycle workflows and roles
  • Search and bulk retrieve content item variants

Use cases of Kontent.ai MCP Server

  • Rapidly prototype content models from diagrams using natural language
  • Visualize and explore content models in any format
  • Create, edit, and manage content types, snippets, and taxonomies
  • Build and publish content items with full workflow control
  • Perform semantic searches across content item variants

FAQ from Kontent.ai MCP Server

What prerequisites are needed to run the server?

You need a Kontent.ai account, a project, a Management API key with appropriate permissions, and your environment ID.

What transports are available?

The server supports STDIO (single‑tenant, local) and Streamable HTTP (multi‑tenant, remote) transports.

How is authentication handled in each mode?

In STDIO mode, credentials are set via environment variables. In Streamable HTTP mode, the environment ID is part of the URL path and the API key is provided as a Bearer token per request.

Is there a risk of indirect prompt injection?

Yes. Content returned by the server can contain text that an LLM may interpret as instructions. Use a least‑privilege Management API key to limit the damage a hijacked agent can cause.

Can I use the server with a preview environment?

Yes. Set the manageApiUrl environment variable to a custom base URL for preview environments (optional).

Frequently asked questions

What prerequisites are needed to run the server?

You need a Kontent.ai account, a project, a Management API key with appropriate permissions, and your environment ID.

What transports are available?

The server supports STDIO (single‑tenant, local) and Streamable HTTP (multi‑tenant, remote) transports.

How is authentication handled in each mode?

In STDIO mode, credentials are set via environment variables. In Streamable HTTP mode, the environment ID is part of the URL path and the API key is provided as a Bearer token per request.

Is there a risk of indirect prompt injection?

Yes. Content returned by the server can contain text that an LLM may interpret as instructions. Use a least‑privilege Management API key to limit the damage a hijacked agent can cause.

Can I use the server with a preview environment?

Yes. Set the `manageApiUrl` environment variable to a custom base URL for preview environments (optional).

Comments

More Other MCP servers