Telerik.MAUI.MCP 1.9.0

Telerik Maui MCP Server

The Telerik Maui MCP Server enables you to achieve integration with your already existing AI workflows and reach new levels of developer productivity. The MCP server provides proprietary context to AI-powered IDEs, apps and tools. You can use the Telerik Maui MCP server to ask about Telerik UI for .NET MAUI components, features, or general usage. You can successfully prompt more complex questions and tasks, and generate tailored code that includes Telerik UI for .NET MAUI components and API.

Prerequisites

To use the Telerik Maui MCP server, you need:

• A compatible MCP client (IDE, code editor or app) that supports MCP tools.
• A Telerik user account.
• An active DevCraft or Telerik UI for .NET MAUI license or a Telerik UI for .NET MAUI trial.
• .NET 10

Installation

Use the documentation of your AI-powered MCP client to add the Telerik MCP server to a specific workspace or globally. You can see installation tips and examples for some popular MCP clients below.

The generic settings of the Telerik Maui MCP server are:

• Server name: telerik-maui-assistant (depends on your preferences)

• Type: stdio (standard input/output transport)

• Command: dnx (the MCP server works through an nuget package)

• Supported arguments: --yes

• nuget package name: Telerik.MAUI.MCP

• You also need to add your Telerik licence key.

  • Place the file (recommended):
    • on Windows at %AppData%/Telerik/telerik-license.txt;
    • on macOS or linux at ~/.telerik/telerik-license.txt;

  OR alternatively:

  • Use a TELERIK_LICENSE_PATH argument and point to your Telerik license file location.
  • Use a TELERIK_LICENSE argument and paste your Telerik license key. Make sure to update the license key when necessary.

.NET 8 & 9 Local Tool Installation

For .NET 8 and 9 projects, you can install the MCP server as a local tool without global installation:

dotnet tool install Telerik.MAUI.MCP

MCP Configuration for .NET 8 & 9 Local Tools

For VS Code .vscode/mcp.json using local tools:

{
  "servers": {
    "telerik-maui-assistant": {
      "type": "stdio",
      "command": "dotnet",
      "args": ["tool", "run", "telerik-maui-assistant"]
    }
  },
  "inputs": []
}

Authentication

The MCP server requires a valid Telerik account with a valid license. In order to get a valid license key check the Telerik UI for .NET MAUI documentation.

Configuration Examples

Visual Studio

Refer to Use MCP servers in Visual Studio.

To enable the Telerik MCP Server in a specific .NET MAUI app, add a .mcp.json file to the solution folder.

SOLUTIONDIR/.mcp.json

{
  "servers": {
    "telerik-maui-assistant": {
      "type": "stdio",
      "command": "dnx",
      "args": ["Telerik.MAUI.MCP", "--yes"]
    }
  },
  "inputs": []
}

• Once the Telerik MCP server is added, make sure that the telerik-maui-assistant tool is enabled (checked) in the Copilot Chat window's tool selection dropdown in Visual Studio.

VSCode - Copilot

Refer to Use MCP servers in VS Code.

To enable the Telerik MCP Server in a specific workspace or .NET MAUI app, add a .vscode folder with an mcp.json file at the root of the workspace:

.vscode/mcp.json at the workspace root

{
  "servers": {
    "telerik-maui-assistant": {
      "type": "stdio",
      "command": "dnx",
      "args": ["Telerik.MAUI.MCP", "--yes"]
    }
  },
  "inputs": []
}

Cursor

Refer to Model Context Protocol.

To enable the Telerik MCP Server in a specific workspace or .NET MAUI app, add a .cursor folder with an mcp.json file at the root of the workspace.

.cursor/mcp.json at the workspace root

{
  "mcpServers": {
    "telerik-maui-assistant": {
      "type": "stdio",
      "command": "dnx",
      "args": ["Telerik.MAUI.MCP"]
    }
  }
}

Usage

By default, MCP clients do not call MCP tools in a deterministic way, unless you explicitly reference the MCP tool in your prompt. To use the Telerik MCP Server:

1. Start your prompt with one of the following:
   • # and the MCP server name that you used in mcp.json (for example, #telerik-maui-assistant)
   • # and the name of the Telerik Maui MCP tool (#telerik_maui_assistant)
2. Confirm that the Telerik MCP server is used. Look for a statement in the output, which is similar to:
   • Running telerik_maui_assistant (in VS Code)
   • Calling MCP tool telerik_maui_assistant (in Cursor)
3. Grant the Telerik tool permission to run for the current session, workspace, or always.
4. If you want to prompt for information or code that are not related to your previous prompts, it is a good practice to start a new session in a new chat window, so that the context is not polluted by irrelevant old information.

Also check the general AI Coding Assistant Recommendations for more usage tips.

To increase the probability of the Telerik Maui MCP Server being used, or to call it without the need to type "#telerik-maui-assistant" explicitly, add custom instructions to your AI-powered tool. Here are examples for GitHub Copilot and Cursor.

Upgrade Assistant

The MCP server includes a telerik-upgrade-assistant tool that analyzes your existing .NET MAUI project for breaking changes when upgrading between Telerik UI for .NET MAUI versions. The tool integrates with the Telerik CLI (telerik migrate analyze) and returns structured findings that the AI model can use to apply fixes automatically.

How it works

1. The tool checks if the Telerik CLI is installed globally. If not, it prompts you to install it.
2. It runs telerik migrate analyze --product maui against your project and parses the JSON output.
3. The findings (file, line, member, old/new API signature) are returned to the AI model, which can then apply the necessary code changes.

Example prompts

• "Upgrade my MAUI project to the latest Telerik version and fix breaking changes"
• "Analyze my project at C:\MyApp\MyApp.csproj for Telerik breaking changes"
• "I want to upgrade from Telerik 15.0.0 to the latest version"

Parameters