| name | kendo-angular-mcp-licensing |
| description | Diagnose and resolve MCP server entitlement failures for @progress/kendo-angular-mcp. Use when MCP tool calls return PERMISSION_DENIED despite a working server, when premium MCP tools don't appear in the IDE, when the AI Coding Assistant stops working (deprecated, migrated to Agentic UI Generator), or when the developer asks whether their license type supports MCP AI tools. Do NOT use for watermarks, banners, or TKL activation codes — those are project licensing issues, route to kendo-angular-product-licensing. Do NOT use for first-time install or onboarding — route to kendo-angular-getting-started. Scoped to Kendo UI for Angular. Trigger on "PERMISSION_DENIED from |
Kendo MCP Licensing — Kendo UI for Angular
Purpose
This skill diagnoses and resolves MCP server entitlement failures for @progress/kendo-angular-mcp. It is the right skill when MCP tool calls return PERMISSION_DENIED despite the server starting correctly, when premium MCP tools don't appear in the IDE, or when the developer asks whether their license covers MCP AI tools.
This skill does NOT cover:
- Watermarks, banners, or TKL activation codes in the app — route to
kendo-angular-product-licensing
- First-time install, onboarding, or "how do I get started" — route to
kendo-angular-getting-started
- Component API, props, or usage questions — route to component docs or
#kendo_component_assistant
Reference files
Load these only when the ticket calls for it — they are not needed for the entitlement matrix, triage order, or IDE config basics, all of which live below.
references/ide-troubleshooting.md — Read when the issue is IDE-specific rather than entitlement: MCP server startup logs (where to find them in VS Code and Cursor), the VS Code # vs Cursor @ tool-handle syntax difference, npx version cache issues causing stale package versions, corporate network/proxy blocking server startup, and the MCP server start button missing or showing an error.references/advanced-diagnostics.md — Read when entitlement should be valid but tools still fail: the full 15-item support debugging checklist, confidence guidance (high/medium/low), decision logic for structured triage, cross-product package-line alignment, trial expiry per-tool behavior, diagnostic signal examples, and the normalized training example.
Path Taxonomy
Classify tickets with one or more of these paths:
mcp_licensing_paths:
- entitlement_mismatch
- tool_scope_gating
- backend_entitlement_sync
- mcp_host_env_propagation
- handoff_execution_failure
- trial_entitlement_provisioning_friction
- activation_or_credential_issue
- mcp_server_tools_not_recognized_in_ide
- mcp_server_start_button_missing
- ai_coding_assistant_deprecated_migration
path_notes:
entitlement_mismatch: >
License type does not include MCP AI tools. Perpetual licenses do not
include MCP tools. Only Trial and active Subscription licenses qualify.
tool_scope_gating: >
Server starts and the free #kendo_getting_started_assistant works, but
premium tools (#kendo_ui_generator and the five specialist assistants)
return PERMISSION_DENIED.
backend_entitlement_sync: >
License is eligible (trial or subscription) but the backend hasn't
synced the entitlement yet. Common after fresh trial activation or
subscription renewal.
mcp_host_env_propagation: >
TELERIK_LICENSE or TELERIK_LICENSE_PATH is set in the shell but not
visible to the MCP server process. The IDE spawns the server in its
own environment; env vars must be in the mcp.json config or globally
available to the IDE process.
handoff_execution_failure: >
Sales or support handoff was initiated but no follow-up occurred.
Collect the handoff payload and re-escalate.
trial_entitlement_provisioning_friction: >
Developer with an existing perpetual or expired account cannot start
a trial via the portal. The trial option may not appear.
MCP Entitlement Matrix
Before diagnosing, determine which license type the developer has. This table is definitive.
| License Type | Free #kendo_getting_started_assistant | Premium MCP Tools (#kendo_ui_generator + specialists) | Notes |
|---|
| Free (no key) | YES | NO | No MCP AI tools beyond the free assistant |
| Trial (30-day) | YES | YES | Full access during trial; PERMISSION_DENIED after expiry |
| Subscription (active) | YES | YES | Full access while subscription is active |
| Subscription (expired) | YES | NO | Renew to restore |
| Perpetual | YES | NO | Not included; access only via a 30-day trial or limited annual quota |
entitlement_rules:
- All Telerik AI tools share a single account-wide request limit.
- Requests through the MCP server count against that same quota.
- As of @progress/kendo-angular-mcp v1.4, the server automatically recognizes the Telerik license and activates the appropriate tools.
- The free
subscription_license_qualifying_names:
- DevCraft Ultimate Subscription
- DevCraft Complete Subscription
- DevCraft UI
Core Triage Order
When PERMISSION_DENIED is reported, work through this checklist in order:
triage_order:
0_distinguish_timeout_from_permission_denied: >
IMPORTANT: A first-call timeout after IDE restart or cold npx invocation is NOT
a PERMISSION_DENIED entitlement issue. The first npx run downloads the package
and may exceed the IDE's tool-call timeout (30–60s). Retry once — if the second
call succeeds, it was a cold-start timeout, not a licensing failure.
Only proceed with entitlement triage if PERMISSION_DENIED appears verbatim
in the error body and is consistent across repeated calls.
1_confirm_license_type: >
Ask: "What type of Telerik license do you have — free, trial, subscription,
or perpetual?" If perpetual, this is an entitlement_mismatch — explain and
offer trial/subscription path. If free with no key, explain that premium
MCP tools require at minimum a trial license.
NAMING TRAP: check the exact license name against the perpetual_naming_trap
in the Entitlement Matrix above — some perpetual licenses contain the word
'Subscription' in their name and can be misidentified.
2_confirm_license_validity: >
Is the trial or subscription still active? Check expiry. If expired,
the fix is renewal or a new trial, not debugging the MCP config.
3_confirm_license_visibility_to_mcp_server: >
The MCP server reads the license from the environment it is spawned in.
Check: is TELERIK_LICENSE or TELERIK_LICENSE_PATH set in the mcp.json
env block, OR is the key placed globally (~/.telerik/telerik-license.txt)?
The IDE spawns the server process — shell env vars may not propagate.
4_confirm_mcp_server_version: >
Run: npm view @progress/kendo-angular-mcp version
Auto-recognition requires v1.4+. If older, update: npx -y @progress/kendo-angular-mcp@latest
5_confirm_backend_sync: >
After fresh trial activation or subscription renewal, the backend may
take a few minutes to sync entitlements. Restart the MCP server and
retry after 5 minutes.
6_confirm_ide_config: >
If the server starts but tools don't appear, this is an IDE config
issue (see IDE Configuration Reference below), not an entitlement issue.
For detailed IDE troubleshooting (startup logs, # vs @ syntax, npx cache,
proxy issues), see references/ide-troubleshooting.md.
7_escalate_if_unresolved:
IDE Configuration Reference
VS Code — workspace level
File: .vscode/mcp.json
{
"servers": {
"kendo-angular-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@progress/kendo-angular-mcp@latest"],
"env": {
"TELERIK_LICENSE_PATH": "THE_PATH_TO_YOUR_LICENSE_FILE"
}
}
}
}
- Global: run
MCP: Open User Configuration from the Command Palette.
chat.mcp.enabled must be true in VS Code settings.- Tools require Agent mode — they do not work in Ask mode.
- After config change, restart VS Code.
VS Code — verifying tools appear
- Open Copilot Chat in Agent mode.
- Type
#kendo_getting_started_assistant — if it autocompletes, the server is running.
- Type
#kendo_ui_generator — if it does not appear but the free tool does, this is a tool_scope_gating entitlement issue.
Cursor — workspace level
File: .cursor/mcp.json
{
"mcpServers": {
"kendo-angular-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@progress/kendo-angular-mcp@latest"],
"env": {
"TELERIK_LICENSE_PATH": "THE_PATH_TO_YOUR_LICENSE_FILE"
}
}
}
}
- Note: Cursor uses
mcpServers (camelCase), VS Code uses servers.
- Global: place the file in your user home folder under
.cursor/.
- After config change, restart Cursor.
- Navigate to Settings → MCP Tools to verify the server is listed and toggled on.
JetBrains
Configured automatically by npx kendo setup angular. Manual setup: follow JetBrains MCP documentation and point to the same npx command.
Common config mistakes
ide_config_pitfalls:
wrong_key_name_in_json:
description: Using "mcpServers" in VS Code config or "servers" in Cursor config.
fix: VS Code uses "servers", Cursor uses "mcpServers".
env_var_not_in_mcp_json:
description: TELERIK_LICENSE is set in the shell but not in the mcp.json env block.
explanation: >
The IDE spawns the MCP server as a child process. Shell env vars may not
propagate depending on how the IDE was launched (e.g., launched from Dock
vs terminal on macOS). Set the env var explicitly in the mcp.json env block
or place the key globally.
ask_mode_instead_of_agent:
description: Developer is in Ask mode in VS Code.
fix:
AI Coding Assistant → Agentic UI Generator Migration
The AI Coding Assistant (#kendo_angular_assistant) was deprecated in February 2026 and replaced by the Agentic UI Generator (#kendo_ui_generator).
migration:
old_tool_handle: '#kendo_angular_assistant'
new_tool_handle: '#kendo_ui_generator'
what_changed:
- The orchestrator tool handle changed.
- The Agentic UI Generator includes five specialist assistants (Component, Layout, Styling, Icon, Accessibility) coordinated by an orchestrator.
- The AI Coding Assistant was component-focused only; the Agentic UI Generator adds full UI generation with styling and layout.
what_to_do:
- Update prompts from '#kendo_angular_assistant'
Sales Handoff Rules
sales_handoff:
perpetual_requesting_mcp:
trigger: Developer has a perpetual license and wants MCP AI tool access.
action: Always escalate to Sales.
payload:
- Account email
- Current license type and product family
- "Requesting MCP AI tool access — perpetual license, needs subscription upgrade or trial"
do_not: Try to "fix" this technically — it is an entitlement boundary.
trial_provisioning_blocked:
trigger: Developer with existing perpetual or expired account cannot start a
Safe Response Templates
Entitlement mismatch (perpetual license)
MCP AI tools (the Agentic UI Generator and the specialist assistants) require an active
Subscription or Trial license. Perpetual licenses do not include these tools.
The free #kendo_getting_started_assistant is available to all license types, including
perpetual — so if that tool works but #kendo_ui_generator returns PERMISSION_DENIED,
your license is recognized but doesn't include MCP AI tool access.
To evaluate the AI tools, start a free 30-day trial: https://www.telerik.com/try/kendo-angular-ui
For a subscription upgrade, I can connect you with Sales.
Eligible but still denied (support escalation)
Your license type (trial/subscription) should include MCP AI tools, and the server is
running correctly. This may be a backend entitlement sync issue.
Please try: restart the MCP server, wait 5 minutes, and retry. If PERMISSION_DENIED
persists, I'll escalate to Support with your account details and the full error message.
AI Coding Assistant deprecated
The AI Coding Assistant (#kendo_angular_assistant) was deprecated in February 2026 and
replaced by the Agentic UI Generator (#kendo_ui_generator).
To migrate:
1. Update the MCP server: ensure @progress/kendo-angular-mcp@latest is in your mcp.json
2. Use #kendo_ui_generator instead of #kendo_angular_assistant in your prompts
The Agentic UI Generator includes everything the AI Coding Assistant did, plus full UI
generation with layout and styling capabilities.
Trial expired
Your 30-day trial has ended, so premium MCP tools now return PERMISSION_DENIED. This is
expected — not a bug or config issue.
To restore access, purchase a commercial subscription:
https://www.telerik.com/kendo-angular-ui/pricing
The free #kendo_getting_started_assistant remains available without any license.
Sales follow-up delay (de-escalation)
I can see the handoff to Sales was submitted. Response times can vary, but the team
typically follows up within a few business days. I'll flag this as a reminder.
In the meantime, if you'd like to evaluate the MCP AI tools immediately, you can start
a free 30-day trial: https://www.telerik.com/try/kendo-angular-ui
Agent-Assisted License Setup for MCP
When the developer provides a path to their license file and asks the agent to configure MCP:
agent_assisted_mcp_setup:
consent_rule: Take no action without explicit user consent.
flow:
1_acknowledge: "I see your license file at [path]. I'll configure the MCP server to use it."
2_state_intent: >
Explain what you will do: update the mcp.json env block to set
TELERIK_LICENSE_PATH pointing to their file, or copy the key to
the global location.
3_ask_permission: "Shall I proceed?"
4_execute: Update the mcp.json file with the env block.
5_verify: "Please restart your IDE and type #kendo_ui_generator in the chat to verify."
do_not:
- Modify mcp.json without asking first.
- Move or delete the developer's license file.
- Set TELERIK_LICENSE (full key content) in mcp.json —
Routing Rules
route_to_kendo_angular_product_licensing_when:
- Developer reports a watermark or licensing banner in the app (not in MCP tools)
- A TKL error code appears (TKL002, TKL003, TKL101–TKL105)
- The issue is project activation, not MCP entitlement
- activation_or_credential_issue is suspected — confirm the key is valid via product licensing first, then return here if PERMISSION_DENIED persists
route_to_kendo_angular_getting_started_when:
- Developer
Anti-Patterns
avoid:
- Treating PERMISSION_DENIED as a project licensing or activation issue — it is an MCP entitlement issue.
- Telling a perpetual license holder to re-download their key or re-activate — that won't fix an entitlement gap.
- Debugging IDE config before confirming the license type supports MCP tools — entitlement first, config second.
- Suggesting the developer suppress
Relationship to Other Skills
skill_relationships:
kendo_angular_getting_started:
relationship: upstream
handoff_trigger: Developer is setting up for the first time or asking about MCP setup (not a failure)
description: Initial onboarding, Phase 4 covers MCP setup
kendo_angular_product_licensing:
relationship: parallel
handoff_trigger: Watermark, banner, or TKL code in the app — not in MCP tools
description: Project activation and runtime licensing
note: >
If both a watermark AND PERMISSION_DENIED are reported, resolve the product
licensing issue first (kendo-angular-product-licensing), then re-check MCP
entitlement. A corrupt or expired key can cause both symptoms.
