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:

Permission	Reason
View all objects (or access to relevant host groups)	Needed for listing hosts and services
Reach API configuration	Required for host/service groups endpoints
Reach API realtime	Required for monitoring, events, metrics endpoints

To use acknowledgement and downtime tools the user also needs:

Permission	Reason
Acknowledge resources	acknowledge_host, acknowledge_service
Schedule downtimes	add_downtime_host, add_downtime_service

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

Variable	Required	Default	Description
CENTREON_HOST	Yes	—	Centreon server hostname or IP (without https://)
CENTREON_USERNAME	No	admin	Centreon login username
CENTREON_PASSWORD	Yes	—	Centreon login password
CENTREON_ALLOW_SELF_SIGNED	No	true	Accept self-signed TLS certificates (true/false)

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

Tool	Description
list_hosts	List monitored hosts; filter by name or state (up/down/unreachable/pending)
get_host	Get full details for a host by ID
list_host_groups	List host groups with member counts
acknowledge_host	Acknowledge a host problem
add_downtime_host	Schedule a maintenance downtime for a host

Services

Tool	Description
list_services	List services; filter by host name, service name, or state
get_service	Get full details for a service by host ID and service ID
list_service_groups	List service groups
acknowledge_service	Acknowledge a service problem
add_downtime_service	Schedule a maintenance downtime for a service

Alerts

Tool	Description
list_events	List recent monitoring events; filter by host, state, or check type (soft/hard)
list_acknowledgements	List active acknowledgements — who acknowledged what and when
list_downtimes	List active and scheduled downtimes

Performance

Tool	Description
get_service_metrics	List available performance metrics for a service
get_metrics_data	Get time-series data for a specific metric

Platform status

Tool	Description
get_platform_status	Platform-level host/service counts broken down by state
get_poller_list	List pollers and remote servers with connectivity status

State mappings

Code	Host state	Service state
0	Up	Ok
1	Down	Warning
2	Unreachable	Critical
3	—	Unknown
4	Pending	Pending

License

SEE LICENSE IN LICENSE