mcp-centreon

MCP server for Centreon IT monitoring — hosts, services, alerts, acknowledgements, and downtimes.

Integrates Claude (or any MCP-compatible AI) with Centreon to query monitoring status, manage acknowledgements and downtimes, and retrieve performance metrics.

Features

• Hosts — list, search, and inspect monitored hosts; acknowledge problems; schedule downtimes
• Services — list and filter services by state or host; acknowledge and schedule downtimes
• Alerts — browse recent events, active acknowledgements, and scheduled/active downtimes
• Performance — list available metrics per service and fetch time-series data
• Platform status — cluster-level host/service state counts; poller topology

API version support

Targets Centreon REST API v2 (/centreon/api/latest/), supported in Centreon 21.04 and later (including 21.10, 22.x, 23.x, 24.x).

The authentication endpoint used is:

POST https://{host}/centreon/api/latest/authentication/providers/configurations/local

If you use an older Centreon installation that only exposes the legacy v1 API, the monitoring endpoints will not be available. Upgrade to Centreon 21.04+ to use this server.

Required Centreon user permissions

A read-only user is sufficient for all monitoring and read operations:

To use acknowledgement and downtime tools the user also needs:

Create the API user in Administration > ACL > ACL Access Groups and assign the relevant ACL menus and actions.

Setup

1. Install

npm install -g mcp-centreon

Or run directly without installing:

npx mcp-centreon

Or clone and build:

git clone https://github.com/fredriksknese/mcp-centreon
cd mcp-centreon
npm install
npm run build

2. Environment variables

3. Claude Desktop configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "centreon": {
      "command": "npx",
      "args": ["mcp-centreon"],
      "env": {
        "CENTREON_HOST": "centreon.example.com",
        "CENTREON_USERNAME": "admin",
        "CENTREON_PASSWORD": "your-password-here",
        "CENTREON_ALLOW_SELF_SIGNED": "true"
      }
    }
  }
}

If you installed globally via npm install -g:

{
  "mcpServers": {
    "centreon": {
      "command": "mcp-centreon",
      "env": {
        "CENTREON_HOST": "centreon.example.com",
        "CENTREON_USERNAME": "admin",
        "CENTREON_PASSWORD": "your-password-here"
      }
    }
  }
}

Available tools

Hosts

Services

Alerts

Performance

Platform status

State mappings

License

SEE LICENSE IN LICENSE