geiserx avatar

GenieACS

geiserx/genieacs-mcp

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 tools

Public 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:7557

GenieACS NBI URL, without a trailing slash

ACS_USER

GenieACS NBI basic-auth username

ACS_PASSsecret

GenieACS NBI basic-auth password

DEVICE_LIMITdefault: 500

Max devices returned by genieacs://devices/list (default 500)

GENIEACS_READ_ONLYdefault: false

Set to true to serve only the tools that never change a device or the ACS

GENIEACS_TOOLS

Comma-separated tool names to serve; every other tool is left out

ACS_TIMEOUTdefault: 30

Seconds to wait for one GenieACS NBI request (default 30)

ACS_MAX_RESPONSE_BYTESdefault: 4194304

Largest 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

More from geiserx