# mcp-server

Hooks your Kontent.ai project into an AI editor so content types, taxonomies, assets and language versions can be handled in plain language.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: kontent-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kontent-ai/mcp-server
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/kontent-ai-mcp-server

## What it does

The server speaks Model Context Protocol and exposes the Kontent.ai Management API to your agent. Content types, snippets, taxonomy groups, assets and asset folders can all be listed and created. Content items get their own toolset: the container itself, language variants, translations, drafts and published versions.

Type and taxonomy edits run as patch operations — `move`, `addInto`, `remove`, `replace`. Call `get-patch-guide` first: it returns the allowed operations per entity type, and skipping it means the agent guesses and the request fails. Semantic search over variants exists, though it filters only by variant ID.

Two transports are available: `npx @kontent-ai/mcp-server@latest stdio` and `npx @kontent-ai/mcp-server@latest shttp`. You need a Kontent.ai account, a project, a Management API key with the right permissions, and the Environment ID. Both values go in through `KONTENT_API_KEY` and `KONTENT_ENVIRONMENT_ID`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `KONTENT_API_KEY`, `KONTENT_ENVIRONMENT_ID`, `PORT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env KONTENT_API_KEY=<KONTENT_API_KEY> --env KONTENT_ENVIRONMENT_ID=<KONTENT_ENVIRONMENT_ID> --env PORT=<PORT> --transport stdio kontent-ai-mcp-server -- npx -y @kontent-ai/mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add kontent-ai-mcp-server --env KONTENT_API_KEY=<KONTENT_API_KEY> --env KONTENT_ENVIRONMENT_ID=<KONTENT_ENVIRONMENT_ID> --env PORT=<PORT> -- npx -y @kontent-ai/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kontent-ai-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@kontent-ai/mcp-server"
            ],
            "env": {
                "KONTENT_API_KEY": "<KONTENT_API_KEY>",
                "KONTENT_ENVIRONMENT_ID": "<KONTENT_ENVIRONMENT_ID>",
                "PORT": "<PORT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kontent-ai-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@kontent-ai/mcp-server"
            ],
            "env": {
                "KONTENT_API_KEY": "<KONTENT_API_KEY>",
                "KONTENT_ENVIRONMENT_ID": "<KONTENT_ENVIRONMENT_ID>",
                "PORT": "<PORT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e KONTENT_API_KEY=<KONTENT_API_KEY> -e KONTENT_ENVIRONMENT_ID=<KONTENT_ENVIRONMENT_ID> -e PORT=<PORT> kontent-ai-mcp-server npx -y @kontent-ai/mcp-server
```
Replace <…> with your own values

## When to use it
- turn a diagram into live content types
- find content by meaning when exact keywords are missing
- add a language version and set its contributor
- rename and reorganise asset folders
- check where a content type is used

## Example prompts
- List every content type in the project and show where `article` is used
- Create a content type `blog-post` with title and body elements
- Find items about shipping and show me their drafts

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

## Other versions with the same name
- [mcp-server · heyputer](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — ★ 43872
- [mcp-server · mapbox](https://affpapa.org/en/nevibecode/mcp/mapbox-mcp-server.md) — ★ 363
- [mcp-server · packmindhub](https://affpapa.org/en/nevibecode/mcp/packmindhub-mcp-server.md) — ★ 319
- [mcp-server · bingowon](https://affpapa.org/en/nevibecode/mcp/bingowon-mcp-server.md) — ★ 121
- [mcp-server · ui5](https://affpapa.org/en/nevibecode/mcp/ui5-mcp-server.md) — ★ 104

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md