Telerik .NET MAUI MCP Server

The Telerik MAUI MCP (Model Context Protocol) Server enhances your AI-powered development experience by providing specialized context about Telerik UI for .NET MAUI components.

This MCP server enables AI-powered IDEs and tools to generate more accurate, tailored code that leverages Telerik UI for .NET MAUI components and APIs. You can ask complex questions about Telerik components, request specific implementations, and generate comprehensive code solutions.

Prerequisites

To use the Telerik MAUI MCP server, you need:

• Node.js 18 or newer.

• An MCP-compatible client that supports MCP tools (latest version recommended).

• A Telerik user account.

• An active DevCraft or Telerik UI for MAUI license or a Telerik UI for MAUI trial.

• A .NET MAUI application that includes Telerik UI for .NET MAUI.

Installation

Install the Telerik MAUI MCP server using npm:

bash

npm i @progress/telerik-maui-mcp

Configuration

Use these settings when configuring the server in your MCP client:

Setting	Value
Package Name	@progress/telerik-maui-mcp
Type	stdio (standard input/output transport)
Command	npx
Arguments	-y
Server Name	telerik-maui-assistant (customizable)

License Configuration

Add your Telerik license key as an environment parameter in your mcp.json file using one of these options:

Option 1: License File Path (Recommended)

json

"env": {
    "TELERIK_LICENSE_PATH": "THE_PATH_TO_YOUR_LICENSE_FILE"
}

Option 2: Direct License Key

json

"env": {
    "TELERIK_LICENSE": "YOUR_LICENSE_KEY_HERE"
}

Option 1 is recommended unless you're sharing settings across different systems. Remember to update your license key when necessary.

Visual Studio

For complete setup instructions, see Use MCP servers in Visual Studio.

Early Visual Studio 17.14 versions require the Copilot Chat window to be open when opening a solution for the MCP server to work properly.

Workspace-Specific Setup:

1. Add .mcp.json to your solution folder:

json

{
  "servers": {
    "telerik-maui-assistant": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@progress/telerik-maui-mcp@latest"],
      "env": {
        "TELERIK_LICENSE_PATH": "THE_PATH_TO_YOUR_LICENSE_FILE",
        // or
        "TELERIK_LICENSE": "YOUR_LICENSE_KEY"
      }
    }
  }
}

2. Restart Visual Studio.
3. Enable the telerik-maui-assistant tool in the Copilot Chat window's tool selection dropdown.

Global Setup:

Add the .mcp.json file to your user directory (%USERPROFILE%, e.g., C:\Users\YourName\.mcp.json).

Visual Studio Code

For complete setup instructions, see Use MCP servers in Visual Studio Code.

Visual Studio Code 1.102.1 or newer is required to use the Telerik MCP Server

The basic setup in Visual Studio Code follows these steps:

1. Enable chat.mcp.enabled in Visual Studio Code settings.
2. Create .vscode/mcp.json in your workspace root (or user folder for global setup):

json

{
  "servers": {
    "telerik-maui-assistant": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@progress/telerik-maui-mcp@latest"],
      "env": {
        "TELERIK_LICENSE_PATH": "THE_PATH_TO_YOUR_LICENSE_FILE",
        // or
        "TELERIK_LICENSE": "YOUR_LICENSE_KEY"
      }
    }
  }
}

3. For global discovery, enable chat.mcp.discovery.enabled in settings.json:

json

{
  "chat.mcp.discovery.enabled": true
}

4. Restart Visual Studio Code.

Cursor

For complete setup instructions, see Model Context Protocol.

Create .cursor/mcp.json in your workspace root (or user folder for global setup):

json

{
  "mcpServers": {
    "telerik-maui-assistant": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@progress/telerik-maui-mcp@latest"],
      "env": {
        "TELERIK_LICENSE_PATH": "THE_PATH_TO_YOUR_LICENSE_FILE",
        // or
        "TELERIK_LICENSE": "YOUR_LICENSE_KEY"
      }
    }
  }
}

Usage

To use the Telerik MCP Server:

1. Start your prompt with one of these triggers:

   • #telerik
   • #telerikmaui
   • #telerik-maui-assistant

2. Verify server activation by looking for these messages:

   • Visual Studio: Running telerik-maui-assistant
   • Visual Studio Code: Running telerik-maui-assistant
   • Cursor: Calling MCP tool telerik-maui-assistant

3. Grant permissions when prompted (per session, workspace, or always).

4. Start fresh sessions for unrelated prompts to avoid context pollution.

Improving Server Usage

To increase the likelihood of the Telerik MCP server being used, add custom instructions to your AI tool:

• GitHub Copilot custom instructions
• Cursor rules

Sample Prompts

The following examples demonstrate useful prompts for the Telerik .NET MAUI MCP Server:

• "#telerik-maui-assistant Create new maui project with Telerik. Add sample usage of the DataGrid component."
• "#telerik-maui-assistant Create a DataGrid with 3 columns - Name, Country, City. Add the corresponding business object in the code behind and populate it with sample data. Add 20 entries to the data."
• "#telerik-maui-assistant Add CollectionView. Enable drag and drop operation in the control."

Number of Requests

A Telerik Subscription license is recommended in order to use the Telerik MAUI AI Coding Assistant without restrictions. Perpetual license holders and trial users can make a limited number of requests per year.

Local AI Model Integration

You can use the Telerik MAUI MCP server with local large language models (LLMs):

1. Run a local model, for example, through Ollama.
2. Use a bridge package like MCP-LLM Bridge.
3. Connect your local model to the Telerik MCP server.

This setup allows you to use the Telerik AI Coding Assistant without cloud-based AI models.

See Also

• Telerik MAUI GitHub Copilot Extension
• AI Coding Assistant Overview