Kontentai MCP server

Connect Kontentai to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

Deploy KontentaiBook a demo

What you can do with the Kontentai MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the manage workflow tool in Kontentai
  • Use the update asset tool in Kontentai
  • Use the list content types tool in Kontentai
  • Use the create content item tool in Kontentai
  • Use the delete asset tool in Kontentai
  • Use the get content item tool in Kontentai

Supported Tools

manage_workflow

Manage Workflow

Manages the workflow state of a content item's language variant. Supports publishing, unpublishing, scheduling, creating new versions, changing workflow steps, and cancelling scheduled operations.

update_asset

Update Asset

Updates an existing asset's metadata including title, descriptions, and folder assignment. Only provided fields are modified.

list_content_types

List Content Types

Retrieves content types from a Kontent.ai environment. Content types define the structure of content items including their elements (fields). Returns type metadata and element definitions.

create_content_item

Create Content Item

Creates a new content item in Kontent.ai. Content items are wrappers for language variants; after creation, use upsert_language_variant to add actual content.

delete_asset

Delete Asset

Permanently deletes an asset from Kontent.ai. The asset must not be referenced by any content items.

get_content_item

Get Content Item

Retrieves a single content item by its ID, codename, or external ID. Returns the item metadata and optionally its language variants with element values.

list_assets

List Assets

Retrieves assets (files, images, documents) from a Kontent.ai environment. Returns asset metadata including file name, URL, size, dimensions, and descriptions.

upsert_language_variant

Upsert Language Variant

Creates or updates a language variant for a content item. Only the provided elements are modified; omitted elements remain unchanged. Use this to set content values (text, rich text, numbers, dates, linked items, assets, taxonomy terms, etc.) on a content item in a specific language.

list_collections

List Collections

Retrieves all collections in the environment. Collections organize content items according to your business structure and can be used to filter content and control access.

get_content_type

Get Content Type

Retrieves a single content type with full details including all element definitions, content groups, and constraints. Useful for understanding the structure of content items before creating or updating them.

list_languages

List Languages

Retrieves a page of languages configured in the environment. Returns language metadata including codename, active status, and fallback language settings. Use language codenames when creating or updating language variants, and continuationToken to fetch more languages.

list_taxonomy_groups

List Taxonomy Groups

Retrieves all taxonomy groups with their hierarchical term structures. Taxonomy groups are used to categorize and classify content items.

list_workflows

List Workflows

Retrieves all workflows defined in the environment. Returns workflow steps, transitions, and scope (which content types and collections the workflow applies to). Useful for understanding available workflow steps before changing a content item's workflow state.

delete_content_item

Delete Content Item

Permanently deletes a content item and all its language variants from Kontent.ai. This action cannot be undone.

get_asset

Get Asset

Retrieves a single asset by its ID or external ID. Returns full asset details including file metadata, descriptions in all languages, and folder information.

list_content_items

List Content Items

Retrieves content items from a Kontent.ai environment. Returns item metadata including name, codename, type, collection, and last modified date. Use the continuation token for paginating through large result sets.

delete_language_variant

Delete Language Variant

Deletes one language variant of a content item. Published variants must be unpublished first. When the deleted variant is the item last remaining variant, the parent content item is also deleted.

get_language_variant

Get Language Variant

Retrieves the latest version of one content item in a specific language, including element values and workflow identifiers. If a draft and a published version both exist, returns the draft. Deactivated languages cannot be retrieved.

get_environment

Get Environment

Retrieves the selected environment ID, project name, environment name, and production status. Use this to verify an environmentId from Kontent.ai project settings and confirm that the API key can access it.

Connect Kontentai to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Kontentai in Metorial. In your Metorial portal, enable the Kontentai MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Kontentai tools.

Run Kontentai through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Kontentai and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Kontentai tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Kontentai

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

Google Sheets

Create, read, and update spreadsheets and their cell data. Read and write values to individual cells, ranges, or multiple ranges using A1 notation or named ranges. Apply cell formatting including text styles, backgrounds, borders, number formats, and conditional formatting. Manage sheets (tabs) within a spreadsheet—add, delete, copy, rename, and reorder them. Create and manage embedded charts, pivot tables, filter views, data validation rules, protected ranges, named ranges, and merged cells. Perform batch operations to apply multiple updates atomically.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Technical notes for Kontentai

Manage structured content in a headless CMS. Create, update, publish, and deliver content items and their language variants across multiple environments. Manage content types, taxonomies, assets, workflows, collections, spaces, and languages. Retrieve published or preview content via REST and GraphQL APIs. Upload and organize binary files and assets with metadata. Define and manage workflow stages and transitions for content lifecycle. Synchronize content changes using queue-based Sync API with continuation tokens. Apply image transformations such as resizing, cropping, and format conversion. Manage users, roles, and project settings.

Frequently asked questions

Common questions about connecting Kontentai to AI agents with Metorial.

  1. How many tools does the Kontentai MCP server have?
    The Kontentai MCP server exposes 19 tools, including Manage Workflow, Update Asset, List Content Types. Each one is governed and traced through Metorial.
  2. Kontentai exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Kontentai MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Kontentai and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Kontentai MCP server yourself or use the hosted gateway.

Connect Kontentai to production AI agents

See how Metorial gives your team governed access to Kontentai, with tracing and security controls built in.

Book a demoDeploy Kontentai