Skip to main content
Glama
calltelemetry

Cisco RIS MCP Server

@calltelemetry/cisco-ris-mcp

MCP server for Cisco CUCM RIS (Real-time Information Service) and PerfMon APIs.

npm CI

Quick Start

npx @calltelemetry/cisco-ris-mcp

Related MCP server: mcp-grafana

Tools

Tool

Description

device_status

Query real-time device registration status with wildcard search, filtering, and auto-pagination

cti_status

Query CTI port, route point, and application connection status

counter_snapshot

One-shot PerfMon counter collection with preset support

counter_list

Discover available PerfMon counter objects and counters

counter_instances

List instances of a PerfMon object

counter_monitor_start

Start background PerfMon monitoring (returns monitorId)

counter_monitor_results

Read accumulated samples and per-counter statistics

counter_monitor_stop

Stop a running monitor and return final statistics

phone_summary

Dashboard-ready phone registration summary with aggregate counts

registration_health

Cluster-wide health check combining RIS + PerfMon with threshold alerts

Configuration

Environment Variables

Variable

Required

Default

Description

CUCM_HOST

Yes

-

CUCM publisher hostname or IP

CUCM_USERNAME

Yes

-

CUCM admin username

CUCM_PASSWORD

Yes

-

CUCM admin password

CUCM_PORT

No

8443

CUCM HTTPS port

RIS_MCP_LOG_LEVEL

No

warn

Log level: debug, info, warn, error

RIS_MCP_TLS_MODE

No

permissive

Set to strict to reject self-signed certs

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

call_processing

Cisco CallManager

CallsActive, CallsAttempted, CallsCompleted

registration

Cisco CallManager

RegisteredHardwarePhones, RegisteredOtherStationDevices, UnregisteredPhoneCount

sip

Cisco SIP

(all counters)

media

Cisco CallManager

VideoCallsActive, VideoCallsCompleted

system

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 + test

License

MIT

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
0dRelease cycle
10Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/calltelemetry/cisco-ris-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server