npm package: @progress/telerik-ajax-mcp
Description: Model Context Protocol server for Telerik UI for ASP.NET AJAX
Latest version: 1.4.2
Deprecated: DEPRECATED: This MCP server is deprecated. Please use the latest version from NuGet: https://www.nuget.org/packages/Telerik.Ajax.MCP

# Telerik UI for ASP.NET AJAX MCP Server

> ⚠️ **DEPRECATED**: This MCP server is deprecated. Please use the latest version from NuGet: https://www.nuget.org/packages/Telerik.Ajax.MCP
>
> Please migrate immediately, as this server will be shut down soon.

The Telerik UI for ASP.NET AJAX [MCP Server](https://modelcontextprotocol.io/introduction) enables you to achieve integration with AI 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 UI for ASP.NET AJAX MCP server to ask about Telerik AJAX controls, features, or general usage. You can successfully prompt more complex questions and tasks, and generate tailored code that includes Telerik UI for ASP.NET AJAX controls and API.

## Prerequisites

To use the Telerik UI for ASP.NET AJAX MCP server, you need:

* A [compatible MCP client (IDE, code editor or app)](https://modelcontextprotocol.io/clients) that supports *MCP tools*.
* A [Telerik user account](https://www.telerik.com/account/).
* An active [DevCraft or Telerik UI for ASP.NET AJAX license](https://www.telerik.com/products/aspnet-ajax.aspx) or a [Telerik UI for ASP.NET AJAX trial](https://www.telerik.com/products/aspnet-ajax.aspx).

## 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 UI for ASP.NET AJAX MCP server are:

* Server name: `telerikAjaxAssistant` (depends on your preferences)
* Type: `stdio` (standard input/output transport)
* Command: `npx` (the MCP server works through an npm package)
* Supported arguments: `-y`
* npm package name: `@progress/telerik-ajax-mcp`
* You also need to add your [Telerik licence key](https://www.telerik.com/products/aspnet-ajax/documentation/licensing/license-key) as an `env` parameter in the `mcp.json` file. There are two options:
    * (recommended) 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.

> * Do not use hyphens (`-`) or underscores (`_`) in the MCP server name in the MCP `.json` file, due to potential compatibility issues with some MCP clients such as Visual Studio or Windsurf.
> * Some MCP clients expect the MCP servers to be listed under a `servers` JSON key, while others expect `mcpServers`.
> * Some MCP clients expect an `mcp.json` file, while others like Visual Studio 2022 expect an `.mcp.json` file.

## 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 ASP.NET AJAX documentation](https://www.telerik.com/products/aspnet-ajax/documentation/licensing/license-key).

To set up the license key, you need to set it up as an environment variable in the JSON configuration file.

## Configuration Examples

### Visual Studio

Refer to [Use MCP servers in Visual Studio](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers).

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

> SOLUTIONDIR/.mcp.json

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

### VSCode - Copilot

Refer to [Use MCP servers in VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).

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

> .vscode/mcp.json at the workspace root

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

### Cursor

Refer to [Model Context Protocol](https://docs.cursor.com/context/model-context-protocol).

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

> .cursor/mcp.json at the workspace root

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

## 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, `#telerikAjaxAssistant`)
    * `#` and the name of the Telerik AJAX MCP tool (`#telerik_ajax_assistant`)
1. Confirm that the Telerik MCP server is used. Look for a statement in the output, which is similar to:
    * `Running telerik_ajax_assistant` (in VS Code)
    * `Calling MCP tool telerik_ajax_assistant` (in Cursor)
1. Grant the Telerik tool permission to run for the current session, workspace, or always.

Also check the general [AI Coding Assistant Recommendations](https://www.telerik.com/products/aspnet-ajax/documentation/ai/overview#recommendations) for more usage tips.

To call the Telerik MCP server without the need to type `#telerikAjaxAssistant` explicitly, add custom instructions to your AI-powered tool. Here are examples for [GitHub Copilot](https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot#about-repository-custom-instructions-for-github-copilot-chat) and [Cursor](https://docs.cursor.com/context/rules).