@teamnetwork/prtg-mcp-server

An MCP server for PRTG Network Monitor that uses the PRTG v2 REST API exclusively — no database, no Data Exporter add-on required.

Compatible with Claude Desktop, Claude Code, Cursor, Cline, and any MCP-capable client.

Requirements

• Node.js 18+
• PRTG Network Monitor 25.1.102.1373 or later with API v2 enabled (tested against 25.1.102.1373+)
• A PRTG API key (PRTG → My Account → API Keys)

Installation

npx @teamnetwork/prtg-mcp-server

Or install globally:

npm install -g @teamnetwork/prtg-mcp-server
prtg-mcp-server

Configuration

Set these environment variables before starting the server:

| Variable | Required | Description | |---|---|---| | PRTG_BASE_URL | yes | Scheme + host + port only — e.g. https://prtg.example.com:1616. Do not append /api/v2. | | PRTG_API_KEY | yes | Bearer token from PRTG → My Account → API Keys | | PRTG_IGNORE_SSL | no | Set true to skip TLS verification (useful for self-signed certs) | | PRTG_READWRITE | no | Set true to enable write/action tools (pause, resume, acknowledge). Default is read-only. |

Claude Desktop configuration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "prtg": {
      "command": "npx",
      "args": ["-y", "@teamnetwork/prtg-mcp-server"],
      "env": {
        "PRTG_BASE_URL": "https://prtg.example.com:1616",
        "PRTG_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code configuration

claude mcp add prtg \
  -e PRTG_BASE_URL=https://prtg.example.com:1616 \
  -e PRTG_API_KEY=your-api-key-here \
  -- npx -y @teamnetwork/prtg-mcp-server

Available tools

Sensors

| Tool | Description | |---|---| | list_sensors | List sensors with filters: status, name, parentid, tags, type | | get_sensor | Get full details for a sensor by ID | | list_alerts | List sensors in down / warning / unusual / acknowledged state |

Devices & groups

| Tool | Description | |---|---| | list_devices | List devices with filters: name, parentid, tags, host | | get_device | Get full details for a device by ID | | list_groups | List groups with optional filters | | list_probes | List probes (top-level monitoring nodes) |

Navigation

| Tool | Description | |---|---| | get_hierarchy | Full object tree: probes → groups → devices (optionally with sensors) | | search | Universal name search across sensors, devices, and groups |

Metrics

| Tool | Description | |---|---| | get_channels | Current channel values for a sensor (value, unit, min/max/avg) | | get_timeseries | Historical data for predefined timeframes: live, short, medium, long | | get_timeseries_custom | Historical data for a custom ISO-8601 date/time range |

System

| Tool | Description | |---|---| | get_statistics | Aggregated counts of sensors/devices/groups by status | | get_license | PRTG license edition, sensor limits, expiry |

Write actions (enabled with PRTG_READWRITE=true; off by default)

| Tool | Description | |---|---| | pause_sensor | Pause a sensor (optionally with message and auto-resume duration) | | resume_sensor | Resume a paused sensor | | acknowledge_alert | Acknowledge a down/warning sensor with a message |

Read-only mode (default)

Write tools (pause_sensor, resume_sensor, acknowledge_alert) are off by default. Set PRTG_READWRITE=true to enable them. When disabled, those tools are never registered — they won't appear in the tool list at all.

Development

npm install
npm run build

# Run locally
PRTG_BASE_URL=https://prtg.example.com:1616 \
PRTG_API_KEY=your-key \
node dist/index.js

Test with the MCP inspector:

npx @modelcontextprotocol/inspector node dist/index.js

License

MIT