Cisco RIS MCP Server
Provides tools for querying real-time device registration status, CTI port and route point status, PerfMon counter collection and monitoring, and cluster-wide health checks for Cisco CUCM (Unified Communications Manager).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Cisco RIS MCP ServerCheck device status for phone SEP1234"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@calltelemetry/cisco-ris-mcp
MCP server for Cisco CUCM RIS (Real-time Information Service) and PerfMon APIs.
Quick Start
npx @calltelemetry/cisco-ris-mcpRelated MCP server: cisco-cucm-mcp
Tools
Tool | Description |
| Query real-time device registration status with wildcard search, filtering, and auto-pagination |
| Query CTI port, route point, and application connection status |
| One-shot PerfMon counter collection with preset support |
| Discover available PerfMon counter objects and counters |
| List instances of a PerfMon object |
| Start background PerfMon monitoring (returns monitorId) |
| Read accumulated samples and per-counter statistics |
| Stop a running monitor and return final statistics |
| Dashboard-ready phone registration summary with aggregate counts |
| Cluster-wide health check combining RIS + PerfMon with threshold alerts |
Configuration
Environment Variables
Variable | Required | Default | Description |
| Yes | - | CUCM publisher hostname or IP |
| Yes | - | CUCM admin username |
| Yes | - | CUCM admin password |
| No |
| CUCM HTTPS port |
| No |
| Log level: debug, info, warn, error |
| No |
| Set to |
All credentials can also be passed per-tool-call via cucm_host, cucm_username, cucm_password, cucm_port parameters.
Counter Presets
Preset | PerfMon Object | Counters |
| Cisco CallManager | CallsActive, CallsAttempted, CallsCompleted |
| Cisco CallManager | RegisteredHardwarePhones, RegisteredOtherStationDevices, UnregisteredPhoneCount |
| Cisco SIP | (all counters) |
| Cisco CallManager | VideoCallsActive, VideoCallsCompleted |
| Processor | (all counters) |
MCP Configuration
Add to your mcp.json:
{
"mcpServers": {
"cucm-ris": {
"command": "npx",
"args": ["@calltelemetry/cisco-ris-mcp"],
"env": {
"CUCM_HOST": "cucm-pub.example.com",
"CUCM_USERNAME": "admin",
"CUCM_PASSWORD": "secret"
}
}
}
}Or with a local build:
{
"mcpServers": {
"cucm-ris": {
"command": "node",
"args": ["/path/to/cisco-ris-mcp/build/index.js"],
"env": {
"CUCM_HOST": "cucm-pub.example.com",
"CUCM_USERNAME": "admin",
"CUCM_PASSWORD": "secret"
}
}
}
}Development
yarn install # Install dependencies
yarn build # Build with Vite
yarn dev # Watch mode
yarn typecheck # Type check
yarn lint # Lint
yarn test # Run tests
yarn validate # typecheck + lint + testLicense
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only MCP server for AIStatusDashboard status, incidents, metrics, and fallback recommendations.
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
A paid remote MCP for AI SDK data query MCP, built to return verdicts, receipts, usage logs, and aud
XFA's remote MCP server — query device posture, compliance, policies & CVEs. Read-only.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server for Cisco Catalyst SD-WAN Manager (vManage) that exposes REST API as tools for AI assistants to query and manage SD-WAN fabric, including device management, monitoring, templates, and policies.9-
- AlicenseNot gradedqualityAmaintenanceMCP server for Cisco CUCM operational debugging — 61 tools covering logs, device inventory, performance monitoring, packet capture, call analysis, service control, AXL discovery, certificates, backups, CTI status, and cluster topology.43 npm2MIT
- AlicenseNot gradedqualityAmaintenanceEnables querying traffic-quality statistics, managing reports, and downloading IP/UA risk databases via MCP.5 npmMIT
- AlicenseAqualityCmaintenanceEnables interaction with RingCentral phone system data, including account info, extensions, presence, call queues, contacts, and call logs/recordings, through MCP tools.13Apache 2.0