mhajder avatar

LibreNMS MCP

mhajder/librenms-mcp

Connects to your LibreNMS instance to query and manage network monitoring data programmatically. Exposes read operations for devices, ports, alerts, inventory, locations, and topology, plus write operations to add/update devices, manage alert rules, and configure maintenance windows. Includes rate limiting, SSL support, and a read-only mode for safe monitoring. You'd reach for this when automating network operations, building custom dashboards, or integrating LibreNMS data into AI-assisted workflows. Supports both stdio and HTTP transports, ships as a PyPI package or Docker image, and requires a LibreNMS API token to authenticate.

GitHub stars
42
tools
80
auth
Secret needed
transport
STDIO, HTTP
env vars
24
last updated
Nov 7, 2026

Tools

80 tools

Public tool metadata for what this MCP can expose to an agent.

devices_listList all devices (with optional filters)

List all devices (with optional filters)

No parameter schema in public metadata yet.

device_getGet details for a specific device

Get details for a specific device

No parameter schema in public metadata yet.

device_addAdd a new device

Add a new device

No parameter schema in public metadata yet.

device_updateUpdate device metadata

Update device metadata

No parameter schema in public metadata yet.

device_deleteRemove a device

Remove a device

No parameter schema in public metadata yet.

device_portsList all ports for a device

List all ports for a device

No parameter schema in public metadata yet.

device_ports_getGet details for a specific port on a device

Get details for a specific port on a device

No parameter schema in public metadata yet.

device_fdbList the forwarding database (learned MACs) for a device

List the forwarding database (learned MACs) for a device

No parameter schema in public metadata yet.

device_nacList network access control (802.1X / MAB) sessions on a device

List network access control (802.1X / MAB) sessions on a device

No parameter schema in public metadata yet.

device_availabilityGet device availability

Get device availability

No parameter schema in public metadata yet.

device_outagesGet device outages

Get device outages

No parameter schema in public metadata yet.

device_set_maintenanceSet device maintenance mode

Set device maintenance mode

No parameter schema in public metadata yet.

device_discoverDiscover or add a device using provided credentials

Discover or add a device using provided credentials

No parameter schema in public metadata yet.

device_renameRename an existing device

Rename an existing device

No parameter schema in public metadata yet.

device_maintenance_statusGet the maintenance status for a device

Get the maintenance status for a device

No parameter schema in public metadata yet.

device_vlansList VLANs for a device

List VLANs for a device

No parameter schema in public metadata yet.

device_linksList links for a device

List links for a device

No parameter schema in public metadata yet.

device_wireless_sensorsList wireless sensors (frequency, clients, rssi, ...) with current values

List wireless sensors (frequency, clients, rssi, ...) with current values

No parameter schema in public metadata yet.

device_parents_setSet the dependency parents of a device (replaces the current set)

Set the dependency parents of a device (replaces the current set)

No parameter schema in public metadata yet.

device_parents_clearRemove dependency parents from a device

Remove dependency parents from a device

No parameter schema in public metadata yet.

device_eventlog_addAdd an event log entry for a device

Add an event log entry for a device

No parameter schema in public metadata yet.

inventory_deviceGet inventory for a device

Get inventory for a device

No parameter schema in public metadata yet.

inventory_device_flatGet flat inventory for a device

Get flat inventory for a device

No parameter schema in public metadata yet.

devicegroups_listList device groups

List device groups

No parameter schema in public metadata yet.

devicegroup_addAdd a device group

Add a device group

No parameter schema in public metadata yet.

devicegroup_updateUpdate a device group

Update a device group

No parameter schema in public metadata yet.

devicegroup_deleteDelete a device group

Delete a device group

No parameter schema in public metadata yet.

devicegroup_devicesList devices in a device group

List devices in a device group

No parameter schema in public metadata yet.

devicegroup_set_maintenanceSet maintenance for a device group

Set maintenance for a device group

No parameter schema in public metadata yet.

devicegroup_add_devicesAdd devices to a device group

Add devices to a device group

No parameter schema in public metadata yet.

devicegroup_remove_devicesRemove devices from a device group

Remove devices from a device group

No parameter schema in public metadata yet.

locations_listList all locations

List all locations

No parameter schema in public metadata yet.

location_addAdd a location

Add a location

No parameter schema in public metadata yet.

location_editEdit a location

Edit a location

No parameter schema in public metadata yet.

location_deleteDelete a location

Delete a location

No parameter schema in public metadata yet.

location_getGet details for a location

Get details for a location

No parameter schema in public metadata yet.

location_set_maintenanceSet maintenance for a location

Set maintenance for a location

No parameter schema in public metadata yet.

ports_listList all ports (with optional filters)

List all ports (with optional filters)

No parameter schema in public metadata yet.

ports_searchSearch ports (general search)

Search ports (general search)

No parameter schema in public metadata yet.

ports_search_fieldSearch ports by a specific field

Search ports by a specific field

No parameter schema in public metadata yet.

ports_search_macSearch ports by MAC address

Search ports by MAC address

No parameter schema in public metadata yet.

port_getGet details for a specific port

Get details for a specific port

No parameter schema in public metadata yet.

port_fdbList MAC addresses learned on a port

List MAC addresses learned on a port

No parameter schema in public metadata yet.

port_ip_infoGet IP address information for a port

Get IP address information for a port

No parameter schema in public metadata yet.

port_transceiverGet transceiver information for a port

Get transceiver information for a port

No parameter schema in public metadata yet.

port_description_getGet a port description

Get a port description

No parameter schema in public metadata yet.

port_description_updateUpdate a port description

Update a port description

No parameter schema in public metadata yet.

port_groups_listList port groups

List port groups

No parameter schema in public metadata yet.

port_group_addAdd a port group

Add a port group

No parameter schema in public metadata yet.

port_group_list_portsList ports in a port group

List ports in a port group

No parameter schema in public metadata yet.

port_group_assignAssign ports to a port group

Assign ports to a port group

No parameter schema in public metadata yet.

port_group_removeRemove ports from a port group

Remove ports from a port group

No parameter schema in public metadata yet.

port_security_listList port security configuration across all devices

List port security configuration across all devices

No parameter schema in public metadata yet.

port_security_deviceGet port security configuration for a device

Get port security configuration for a device

No parameter schema in public metadata yet.

port_security_portGet port security configuration for a single port

Get port security configuration for a single port

No parameter schema in public metadata yet.

device_graphs_listList the graph types available for a device

List the graph types available for a device

No parameter schema in public metadata yet.

device_graphRender a device-level graph (e.g. device_icmp_perf)

Render a device-level graph (e.g. device_icmp_perf)

No parameter schema in public metadata yet.

port_graphRender a per-port graph by interface name

Render a per-port graph by interface name

No parameter schema in public metadata yet.

port_group_graphRender a traffic graph for one or more ports by port ID

Render a traffic graph for one or more ports by port ID

No parameter schema in public metadata yet.

alerts_getList current and historical alerts

List current and historical alerts

No parameter schema in public metadata yet.

alert_get_by_idGet details for a specific alert

Get details for a specific alert

No parameter schema in public metadata yet.

alert_acknowledgeAcknowledge an alert

Acknowledge an alert

No parameter schema in public metadata yet.

alert_unmuteUnmute an alert

Unmute an alert

No parameter schema in public metadata yet.

alert_rules_listList alert rules

List alert rules

No parameter schema in public metadata yet.

alert_rule_getGet details for a specific alert rule

Get details for a specific alert rule

No parameter schema in public metadata yet.

alert_rule_addAdd an alert rule

Add an alert rule

No parameter schema in public metadata yet.

alert_rule_editEdit an alert rule

Edit an alert rule

No parameter schema in public metadata yet.

alert_rule_deleteDelete an alert rule

Delete an alert rule

No parameter schema in public metadata yet.

alert_templates_listList all alert templates

List all alert templates

No parameter schema in public metadata yet.

alert_template_getGet a specific alert template

Get a specific alert template

No parameter schema in public metadata yet.

alert_template_createCreate a new alert template

Create a new alert template

No parameter schema in public metadata yet.

alert_template_editEdit an alert template

Edit an alert template

No parameter schema in public metadata yet.

logs_eventlogGet event log for a device, or for all devices when no hostname is given

Get event log for a device, or for all devices when no hostname is given

No parameter schema in public metadata yet.

logs_syslogGet syslog for a device, or for all devices when no hostname is given

Get syslog for a device, or for all devices when no hostname is given

No parameter schema in public metadata yet.

logs_alertlogGet alert log for a device, or for all devices when no hostname is given

Get alert log for a device, or for all devices when no hostname is given

No parameter schema in public metadata yet.

logs_authlogGet the server-wide authentication log

Get the server-wide authentication log

No parameter schema in public metadata yet.

logs_syslogsinkAdd a syslog sink

Add a syslog sink

No parameter schema in public metadata yet.

bills_listList bills

List bills

No parameter schema in public metadata yet.

bill_getGet details for a bill

Get details for a bill

No parameter schema in public metadata yet.

bill_graphRender a bill graph as an image

Render a bill graph as an image

No parameter schema in public metadata yet.

Sponsors

Configuration

LIBRENMS_URL*

LibreNMS instance URL (e.g., https://librenms.example.com)

LIBRENMS_TOKEN*secret

LibreNMS API token with appropriate permissions

LIBRENMS_VERIFY_SSLdefault: true

Verify TLS certificates for LibreNMS requests (true/false)

LIBRENMS_TIMEOUTdefault: 30

HTTP timeout for LibreNMS API requests in seconds

READ_ONLY_MODEdefault: false

Enable read-only mode to block write operations

REDACT_SNMP_CREDENTIALSdefault: true

Replace SNMP community and SNMPv3 credentials in API responses with <redacted>

DISABLED_TAGS

Comma-separated tool tags to disable (e.g., alerts,bills)

LOG_LEVELdefault: INFO

Logging level (DEBUG, INFO, WARNING, ERROR)

RATE_LIMIT_ENABLEDdefault: false

Enable per-client rate limiting (true/false)

RATE_LIMIT_MAX_REQUESTSdefault: 100

Maximum requests allowed per rate-limit window

RATE_LIMIT_WINDOW_MINUTESdefault: 1

Rate-limit window duration in minutes

TOOL_SEARCH_ENABLEDdefault: false

Enable FastMCP tool search transform

TOOL_SEARCH_STRATEGYdefault: bm25

Tool search strategy: 'bm25' (natural language) or 'regex' (pattern match)

TOOL_SEARCH_MAX_RESULTSdefault: 5

Maximum number of tools returned by search_tools

RESOLVE_SHORT_HOSTNAMESdefault: false

Resolve short device names to the stored hostname of the one matching device

MCP_HTTP_PORTdefault: 8000

Port for HTTP server (default: 8000)

MCP_HTTP_BEARER_TOKENsecret

Optional bearer token for HTTP transport authentication

MCP_TRANSPORTdefault: http

MCP transport type: stdio, sse, or http (alias: streamable-http). Unknown values stop the server at startup.

SENTRY_DSNsecret

Sentry DSN for optional error tracking

SENTRY_TRACES_SAMPLE_RATEdefault: 1.0

Sentry traces sample rate (0.0-1.0)

SENTRY_SEND_DEFAULT_PIIdefault: false

Allow Sentry to include default PII, including tool inputs and outputs, in events (true/false)

SENTRY_ENVIRONMENT

Sentry environment name (e.g., production)

SENTRY_RELEASE

Sentry release identifier

SENTRY_PROFILE_SESSION_SAMPLE_RATEdefault: 1.0

Sentry profile session sample rate (0.0-1.0)

Readme

LibreNMS MCP Server

Let AI agents query and manage LibreNMS network monitoring through the Model Context Protocol

PyPI Python License


View the full README on GitHub

Details

Repository
github.com/mhajder/librenms-mcp
Website
github.com/mhajder/librenms-mcp
Category
Cloud & Infrastructure
Package
librenms-mcp
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

More from mhajder

Related Cloud & Infrastructure MCP servers

View all
1aniongithub avatardevcontainer-mcpaniongithub/devcontainer-mcpManage dev container environments via MCP (Docker, DevPod, Codespaces).28stars
2ionos-cloud avatarIONOS CLOUD MCP Serverionos-cloud/ionoscloud-mcpInspect and manage IONOS CLOUD infrastructure via MCP. Writes are opt-in and off by default.11stars
3whw23 avatarSearXNG HTTP MCPwhw23/searxng_http_mcpSelf-contained SearXNG metasearch MCP server. One Docker image, 200+ engines, privacy-first.8stars
4mikhae1 avatarKubeviewmikhae1/kubeview-mcpRead-only Model Context Protocol MCP server enabling code-driven AI analysis of Kubernetes clusters.5stars
5jmagar avatarCortex RMCPjmagar/cortexRust MCP server for homelab logs, syslog, Docker logs, FTS search, and AI transcript correlation.4stars
6notharshhaa avatarDevops Mcpnotharshhaa/devops-mcpUnified MCP server for Kubernetes, ArgoCD, Prometheus, PagerDuty, and Loki4stars