
GenieACS
Bridges GenieACS TR-069 auto-configuration servers to LLMs through MCP, exposing both read-only resources (device details, presets, provisions, faults) and write operations (reboot, firmware downloads, parameter get/set, tagging, connection requests). Written in Go with stdio and HTTP transports. You can query device lists, manage presets and provisions, search CPE fleets, and handle task lifecycles all through natural language. Tested with MCP Inspector but still gathering real-world LLM client feedback. Ships as an npm package that downloads pre-built binaries or runs in Docker Compose alongside the full GenieACS stack. Part of a larger GenieACS ecosystem that includes Ansible collections, Home Assistant integrations, and n8n workflow nodes.
- GitHub stars
- 19
- tools
- 3
- auth
- Secret needed
- transport
- STDIO
- env vars
- 8
- last updated
- Oct 28, 2026
Tools
3 toolsPublic tool metadata for what this MCP can expose to an agent.
search_devicesFinds devices using a MongoDB-style filter, for example by tag, model, firmware or last inform.
Finds devices using a MongoDB-style filter, for example by tag, model, firmware or last inform.
No parameter schema in public metadata yet.
get_parameterReads a TR-069 parameter value from a device.
Reads a TR-069 parameter value from a device.
No parameter schema in public metadata yet.
reboot_deviceQueues a reboot task on a device.
Queues a reboot task on a device.
No parameter schema in public metadata yet.
Sponsors
Configuration
ACS_URLdefault: http://localhost:7557GenieACS NBI URL, without a trailing slash
ACS_USERGenieACS NBI basic-auth username
ACS_PASSsecretGenieACS NBI basic-auth password
DEVICE_LIMITdefault: 500Max devices returned by genieacs://devices/list (default 500)
GENIEACS_READ_ONLYdefault: falseSet to true to serve only the tools that never change a device or the ACS
GENIEACS_TOOLSComma-separated tool names to serve; every other tool is left out
ACS_TIMEOUTdefault: 30Seconds to wait for one GenieACS NBI request (default 30)
ACS_MAX_RESPONSE_BYTESdefault: 4194304Largest GenieACS NBI response the server reads, in bytes (default 4194304)
Readme
Details
- Repository
- github.com/geiserx/genieacs-mcp
- Website
- geiserx.github.io/genieacs-mcp
- Package
genieacs-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active