Documentation MCP server

The Xperience by Kentico Documentation MCP Server allows AI agents to securely access complete and up-to-date documentation, including guides and API examples. The MCP server provides guidance for all areas of Xperience by Kentico, for example content management, digital marketing, or digital commerce, directly within your integrated development environment (IDE).

The MCP server is built on the Model Context Protocol (MCP), an open standard that lets clients dynamically discover and query external data sources in real time. The server provides accurate, context-aware responses by combining semantic search with high-quality content retrieval from the official documentation in markdown format. Since the server syncs continuously with the published documentation, you’ll always get the most recent information and implementation details available.

Install the MCP server

The MCP server supports quick installation across multiple IDEs. Choose your preferred client below for a streamlined setup:

Development environment

Installation

Documentation

VS Code

Install in VS Code

VS Code MCP Official Guide

Visual Studio

Manual configuration required by adding a new tool in Select tools in the Copilot chat window.

Required parameters:
Type: HTTP/SSE
URL: “https://docs.kentico.com/mcp”

Visual Studio MCP Official Guide

Claude Desktop

Manual configuration required.

For the URL, use https://docs.kentico.com/mcp.

Claude Desktop Remote MCP Guide

Cursor IDE

Install in Cursor

Cursor MCP Official Guide

Example: Add the MCP server to VS Code

Before adding the MCP server to your VS Code, make sure you have set up the GitHub Copilot.

  1. Open GitHub Copilot in VS Code and switch to Agent mode.
  2. Select Configure Tools in the right bottom corner of the chat window, next to the Send button.
  3. Check the box next to the MCP Server: kentico.docs.mcp.
  4. The agent should be able to use the MCP server tools to complete your query.

The Xperience by Kentico MCP server endpoint

The Xperience by Kentico MCP Server is accessible to any IDE, agent, or tool that supports the Model Context Protocol (MCP). Any compatible client can connect to the following remote MCP endpoint: https://docs.kentico.com/mcp.

JSON
Example JSON configuration

{
  "kentico.docs.mcp": {
    "type": "http",
    "url": "https://docs.kentico.com/mcp"
  }
}

This URL is intended for use within a compliant MCP client via Streamable HTTP, such as the recommended clients listed in the installation section. It does not support direct access from a web browser and may return a 405 Method Not Allowed error if accessed manually.

If your client doesn’t support native remote MCP servers or if you prefer local configuration, you can use mcp-remote as a proxy. Configure MCP servers in .mcp.json at your project root.

JSON
mcp-remote example


{
  "mcpServers": {
    "remote-example": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://docs.kentico.com/mcp"
      ]
    }
  }
}

MCP server tools

In the context of the MCP server, tools are individual capabilities that the MCP server exposes to connected clients (for example GitHub Copilot, Claude, or Cursor). Each tool performs a specific function, such as searching or fetching, and can be called programmatically by the client when it needs information from the server.

The MCP server currently provides two tools that let AI agents access official Kentico documentation:

Tool name

Description

Parameters

kentico_docs_search

Performs hybrid (vector + semantic + text-based) search against Xperience by Kentico official documentation

question (string): The question to search for in the documentation

kentico_docs_fetch

Downloads and converts Kentico documentation HTML content to markdown format

url (string): URL of the Kentico documentation page to read (must be from docs.kentico.com)

Example prompts

Your AI assistant should automatically use these tools for Xperience by Kentico-related topics. With both search and fetch capabilities, you can get quick answers or comprehensive deep dives. To ensure that it always consults the official documentation, you can add phrases like search Kentico docs, use XbyK docs, fetch full Xperience docs. For example:

  • “How do I create a custom page type in Xperience by Kentico? Search Kentico docs.”
  • “Are you sure this is the right way to implement custom form components in Xperience by Kentico? Search Kentico docs and fetch full doc.”
  • “Get me the full step-by-step tutorial for setting up multi-site management. Search Kentico docs and deep dive.”

Troubleshooting

If the MCP Server isn’t responding as expected or the tools don’t appear in your environment, the following guidance can help resolve common issues quickly.

Ensure AI clients use MCP tools

Some AI clients, such as Claude or GitHub Copilot, may not automatically use MCP tools when answering Kentico-related queries. To improve reliability, you can define a system prompt that explicitly tells the client to use the Xperience by Kentico MCP tools.

Here’s an example of a Cursor rule (a system prompt) that will cause the LLM to utilize kentico.docs.mcp more frequently:

Example system prompt (Cursor rule)

## Querying Xperience by Kentico Documentation

You have access to MCP tools called `kentico_docs_search` and `kentico_docs_fetch`. These tools allow you to search through and fetch Kentico’s latest official documentation, and that information might be more detailed or newer than what’s in your training data set.

When handling questions around Xperience by Kentico, content management, digital marketing features, commerce functionality, custom development, page builders, form builders, email marketing, or any other Kentico-specific topics. Please use these tools for research purposes when dealing with specific/narrowly defined questions that may occur.

Common Issues

Issue

Solution

Connection errors

Verify your network connection and that the server URL is correctly entered

No results returned

Try rephrasing your query with more specific Xperience by Kentico terms

Tool not appearing in VS Code

Restart VS Code or check that the MCP extension is properly installed

HTTP status 405

Method not allowed happens when a browser tries to connect to the endpoint. Try using the MCP Server through VS Code GitHub Copilot or MCP Inspector instead.

Fetch tool returns error

Ensure the URL is from docs.kentico.com domain only