# Kontent.ai — how to use (mcp.ai)

Connect your Kontent.ai account and use 7 tools for documents straight from your AI agent. Connect with your own API key. Kontent.ai is a headless CMS that delivers content via API, allowing developers to build websites and applications using their preferred frameworks, languages, or libraries.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_kontent_ai?ms=1787295960000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `kontent_ai_get_content_item`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/kontent_ai`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/kontent_ai/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/kontent_ai/get/content/item` — Tool to retrieve a specific content item by its identifier. Use after confirming the environment ID and item identifier.
  - body: { environment_id?: string, item_identifier: string }
- `POST https://api.mcp.ai/api/kontent_ai/get/language` — Tool to retrieve a specific language by its ID. Supports Management API directly and Delivery API via normalization.
  - body: { environment_id?: string, language_identifier: string }
- `POST https://api.mcp.ai/api/kontent_ai/get/language/variant` — Tool to retrieve a specific language variant of a content item. Use after confirming the item and language identifiers when needing localized content.
  - body: { environment_id?: string, language_identifier: string, content_item_identifier: string }
- `POST https://api.mcp.ai/api/kontent_ai/get/types/element` — Tool to retrieve a specific element from a content type by codename. Use when you need to get details about an element's configuration within a content type.
  - body: { type_codename: string, environment_id?: string, element_codename: string, wait_for_loading_new_content?: boolean }
- `POST https://api.mcp.ai/api/kontent_ai/list/content/items` — Tool to list content items from the Delivery API. Use when fetching content items for a specified environment, optionally providing a continuation token for pagination.
  - body: { environment_id?: string, continuation_token?: string }
- `POST https://api.mcp.ai/api/kontent_ai/list/content/types` — Tool to list content types within a Kontent.ai environment. Use when you need to retrieve a paginated list of content type definitions. Use after confirming the environment ID.
  - body: { continuation?: string, environment_id?: string }
- `POST https://api.mcp.ai/api/kontent_ai/list/languages` — Tool to list languages in a Kontent.ai project. Use when you need to retrieve all languages for a specified environment after confirming the project ID.
  - body: { skip?: integer, limit?: integer, order?: string, environment_id?: string }

## Example prompts
- "What can I do in Kontent.ai?"
- "Show me a summary of my Kontent.ai account"

## More
- Page: https://mcp.ai/kontent_ai
- Agent spec (llms.txt): https://mcp.ai/kontent_ai/llms.txt
- Postman collection: https://mcp.ai/kontent_ai/postman.json