Model Context Protocol for Telerik Reporting
npm install @progress/telerik-reporting-mcpThe Telerik Reporting MCP (Model Context Protocol) Server enhances your AI-powered development experience by providing specialized context about Telerik Reporting.
This MCP server enables AI-powered IDEs and tools to generate more accurate, tailored code that leverages Telerik Reporting APIs. You can ask complex questions about integrating Telerik Reporting in web applications, request specific implementations, and generate comprehensive code solutions.
To use the Telerik Reporting MCP Server, you need:
* Node.js 18 or newer.
* An MCP-compatible client (IDE, code editor, or app) that supports MCP tools (latest version recommended).
* A Telerik user account.
* An active DevCraft or Telerik Reporting license or a Telerik Reporting trial.
* An application that uses the Telerik Reporting.
Install the Telerik Reporting MCP server using npm:
```bash``
npm i @progress/telerik-reporting-mcp
Use these settings when configuring the server in your MCP client:
|Setting|Value|
|----|----|
| Package Name | @progress/telerik-reporting-mcp |stdio
| Type | (standard input/output transport) |npx
| Command | |-y
| Arguments | |telerik-reporting-assistant
| Server Name | (customizable) |
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.
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.
1. Add .mcp.json to your solution folder (mind the leading dot '.'):
``json``
{
"servers": {
"telerik-reporting-assistant": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@progress/telerik-reporting-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-reporting-assistant tool in the Copilot Chat window's tool selection dropdown.
Add the .mcp.json file to your user directory (%USERPROFILE%, e.g., C:\Users\{user}\.mcp.json).
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-reporting-assistant": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@progress/telerik-reporting-mcp@latest"],
"env": {
"TELERIK_LICENSE_PATH": "THE_PATH_TO_YOUR_LICENSE_FILE",
// or
"TELERIK_LICENSE": "YOUR_LICENSE_KEY"
}
}
}
}
This enables you to call the MCP Server with the #telerik-reporting-assistant handle. To use a custom handle, change the server name in the mcp.json.
3. For global discovery, enable chat.mcp.discovery.enabled in settings.json:
``json``
{
"chat.mcp.discovery.enabled": true
}
4. Restart Visual Studio Code.
!Installed Reporting MCP Server in VS Code
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-reporting-assistant": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@progress/telerik-reporting-mcp@latest"],
"env": {
"TELERIK_LICENSE_PATH": "THE_PATH_TO_YOUR_LICENSE_FILE",
// or
"TELERIK_LICENSE": "YOUR_LICENSE_KEY"
}
}
}
}
This enables you to call the MCP Server with the #telerik-reporting-assistant handle. To use a custom handle, change the server name in the mcp.json.
> When switching between tasks and files, start a new session in a new chat window to avoid polluting the context with irrelevant or outdated information.
To use the Telerik Reporting MCP Server:
1. Choose your preferred mode and model.
At the time of publishing, Claude Sonnet 4 and GPT-5 produce optimal results.
2. Start your prompt with #telerik-reporting-assistant (or with '#' followed by your custom MCP server name, if set):
3. Inspect the output and verify that the MCP server is used. Look for messages similar to the ones below:
- Visual Studio: Running telerik-reporting-assistantRunning telerik-reporting-assistant
- Visual Studio Code: Calling MCP tool telerik-reporting-assistant
- Cursor:
4. If the Telerik Reporting MCP server is not used even though it's installed and enabled, double-check the server name in your configuration and try rephrasing your prompt.
5. If requested, grant the Telerik Reporting MCP Server permissions to run for this session, workspace, or always.
6. Start fresh sessions for unrelated prompts to avoid context pollution.
Determining the Reporting Area: To better specify the context for each prompt, the MCP Server will attempt to determine the Telerik Reporting Area the prompt relates to. These areas represent the supported web frameworks and backend technologies, as listed below as pairs consisting of identifier and description:
- AngularWrapper - _Angular Report Viewer (wrapper of the HTML5 Report Viewer)_
- NativeAngular - _Native Angular Report Viewer (built with Kendo UI for Angular)_
- BlazorWrapper- _Blazor Report Viewer (wrapper of the HTML5 Report Viewer)_
- NativeBlazor - _Native Blazor Report Viewer (built with Telerik UI for Blazor)_
- HTML5 - _HTML5 Report Viewer (built with Kendo UI for jQuery)_
- React - _React Report Viewer (wrapper of the HTML5 Report Viewer)_
- RESTService - _Reporting REST Service for .NET Framework_
- RESTServiceCore - _Reporting REST Service for .NET Core/.NET 8+_
- WebFormsWrapper - _WebForms Report Viewer (wrapper of the HTML5 Report Viewer)_
- MVCWrapper - _MVC Report Viewer (wrapper of the HTML5 Report Viewer)_
- WinForms - _WinForms Report Viewer (native desktop component)_
- WPF - _WPF Report Viewer (native desktop component)_
- WRDHTML5 - _Web Report Designer for HTML5_
- WRDBlazorWrapper - _Web Report Designer for Blazor (wrapper of the HTML5 Report Designer)_
- WRDRestService - _Web Report Designer REST Service for .NET Framework 4.6.2_
- WRDRestServiceCore - _Web Report Designer REST Service for .NET 8_
- General - _General question_
If the Reporting Area cannot be determined automatically, the MCP Server will display a dialog asking to pick the corresponding area in which the prompt falls in:
!A notification requesting input for the Reporting Area of the asked question
After clicking on 'Respond' button, the MCP Server will display a drop-down list with all the areas and wait for selecting the corresponding Reporting Area. If there is no applicable entry, please select 'General' entry at the end of the list.
!Select a Reporing Area from the dropdown
Custom Instructions: To increase the likelihood of the Telerik MCP server being used, or to call it without the need to mention "telerik-reporting" explicitly, add custom instructions to your AI tool:
- GitHub Copilot custom instructions
- Cursor rules
The following examples demonstrate useful prompts for the Telerik Reporting MCP Server:
* "#telerik-reporting-assistant Add a Telerik Report Viewer to my native Angular application."#telerik-reporting-assistant` Connect the Telerik Report Viewer to my Telerik Report Server instance."
* "
> Visit the Telerik Reporting Prompt Library for more sample prompts.
A Telerik Subscription license is recommended in order to use the Telerik Reporting AI Coding Assistant without restrictions. Perpetual license holders and trial users can make a limited number of requests per year.
You can use the Telerik Reporting MCP server with local large language models (LLMs):
1. Run a local model, for example, through Ollama.
1. Use a bridge package like MCP-LLM Bridge.
1. 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.
* AI Coding Assistant Overview
* Telerik Reporting Prompt Library
* For applications using Native Angular Report Viewer see the Kendo UI for Angular MCP Server article.
* For applications using Native Blazor Report Viewer see the Telerik Blazor MCP Server article.