
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 toolsPublic 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*secretLibreNMS API token with appropriate permissions
LIBRENMS_VERIFY_SSLdefault: trueVerify TLS certificates for LibreNMS requests (true/false)
LIBRENMS_TIMEOUTdefault: 30HTTP timeout for LibreNMS API requests in seconds
READ_ONLY_MODEdefault: falseEnable read-only mode to block write operations
REDACT_SNMP_CREDENTIALSdefault: trueReplace SNMP community and SNMPv3 credentials in API responses with <redacted>
DISABLED_TAGSComma-separated tool tags to disable (e.g., alerts,bills)
LOG_LEVELdefault: INFOLogging level (DEBUG, INFO, WARNING, ERROR)
RATE_LIMIT_ENABLEDdefault: falseEnable per-client rate limiting (true/false)
RATE_LIMIT_MAX_REQUESTSdefault: 100Maximum requests allowed per rate-limit window
RATE_LIMIT_WINDOW_MINUTESdefault: 1Rate-limit window duration in minutes
TOOL_SEARCH_ENABLEDdefault: falseEnable FastMCP tool search transform
TOOL_SEARCH_STRATEGYdefault: bm25Tool search strategy: 'bm25' (natural language) or 'regex' (pattern match)
TOOL_SEARCH_MAX_RESULTSdefault: 5Maximum number of tools returned by search_tools
RESOLVE_SHORT_HOSTNAMESdefault: falseResolve short device names to the stored hostname of the one matching device
MCP_HTTP_PORTdefault: 8000Port for HTTP server (default: 8000)
MCP_HTTP_BEARER_TOKENsecretOptional bearer token for HTTP transport authentication
MCP_TRANSPORTdefault: httpMCP transport type: stdio, sse, or http (alias: streamable-http). Unknown values stop the server at startup.
SENTRY_DSNsecretSentry DSN for optional error tracking
SENTRY_TRACES_SAMPLE_RATEdefault: 1.0Sentry traces sample rate (0.0-1.0)
SENTRY_SEND_DEFAULT_PIIdefault: falseAllow Sentry to include default PII, including tool inputs and outputs, in events (true/false)
SENTRY_ENVIRONMENTSentry environment name (e.g., production)
SENTRY_RELEASESentry release identifier
SENTRY_PROFILE_SESSION_SAMPLE_RATEdefault: 1.0Sentry 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
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