GenieACS
MCP server that lets an AI client read and manage GenieACS TR-069 devices
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.4.1
- Listing updated
- 2 days ago
About GenieACS
GenieACS is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.
GenieACS manages routers, ONTs and other CPE devices over TR-069, and this server puts an assistant in front of its NBI (port 7557). You can ask which devices stopped informing last night, what firmware a given serial runs, or to reboot every device tagged pilot.
It exposes 7 resources (device list, device detail, tasks, faults, files, presets, provisions) and 12 tools. Only search_devices, get_parameter and the resources read; the other ten queue tasks on a device or change the ACS, and each tool's annotations say which, so a client can ask before acting. GENIEACS_READ_ONLY=true keeps just the reading tools, and GENIEACS_TOOLS limits it to names you list.
It keeps no database of its own and never talks to devices directly, so an unreachable device fails as it would in the GenieACS UI. It ships as one Go binary, an npm package and a Docker image, over stdio or HTTP.
Install
Run in a terminal
claude mcp add genieacs-mcp --env ACS_PASS='<ACS_PASS>' -- npx -y genieacs-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"genieacs-mcp": {
"command": "npx",
"args": [
"-y",
"genieacs-mcp"
],
"env": {
"ACS_PASS": "<ACS_PASS>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"genieacs-mcp": {
"command": "npx",
"args": [
"-y",
"genieacs-mcp"
],
"env": {
"ACS_PASS": "<ACS_PASS>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"genieacs-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"genieacs-mcp"
],
"env": {
"ACS_PASS": "<ACS_PASS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"genieacs-mcp": {
"command": "npx",
"args": [
"-y",
"genieacs-mcp"
],
"env": {
"ACS_PASS": "<ACS_PASS>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"genieacs-mcp": {
"command": "npx",
"args": [
"-y",
"genieacs-mcp"
],
"env": {
"ACS_PASS": "<ACS_PASS>"
}
}
}
}Configuration
ACS_URLGenieACS NBI URL, without a trailing slashACS_USERGenieACS NBI basic-auth usernameACS_PASSGenieACS NBI basic-auth passwordDEVICE_LIMITMax devices returned by genieacs://devices/list (default 500)GENIEACS_READ_ONLYSet to true to serve only the tools that never change a device or the ACSGENIEACS_TOOLSComma-separated tool names to serve; every other tool is left outACS_TIMEOUTSeconds to wait for one GenieACS NBI request (default 30)ACS_MAX_RESPONSE_BYTESLargest GenieACS NBI response the server reads, in bytes (default 4194304)ACS_URLGenieACS NBI URL, without a trailing slashACS_USERGenieACS NBI basic-auth usernameACS_PASSGenieACS NBI basic-auth passwordDEVICE_LIMITMax devices returned by genieacs://devices/list (default 500)GENIEACS_READ_ONLYSet to true to serve only the tools that never change a device or the ACSGENIEACS_TOOLSComma-separated tool names to serve; every other tool is left outACS_TIMEOUTSeconds to wait for one GenieACS NBI request (default 30)ACS_MAX_RESPONSE_BYTESLargest GenieACS NBI response the server reads, in bytes (default 4194304)
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- search_devices
- Finds devices with a MongoDB-style filter; read only.
- get_parameter
- Reads a device parameter from the ACS cache without contacting the device.
- reboot_device
- Queues a reboot task on a device.
- set_parameter
- Queues a parameter change on a device.
What it does
- Filter-based device search
- search_devices takes a MongoDB-style filter on tags, model, firmware or last inform.
- Device actions
- Queue reboots, firmware downloads, parameter refreshes and sets.
- ACS management
- Tag devices, manage presets and provisions, retry or delete tasks.
- Read-only mode
- GENIEACS_READ_ONLY serves only tools that never change anything.
- Tool allowlist
- GENIEACS_TOOLS limits which tools are served.
- Network safety
- HTTP mode binds to loopback unless a bearer token is set, with Host and Origin checks.
- Several install routes
- npm, Docker image or a local build.
Good for
- Find CPE devices that have not informed since yesterday
- Reboot a tagged group of routers from a chat
- Check which firmware a device runs
- Audit pending faults and tasks on the ACS
- Give support staff a read-only view of device state
Pricing
Open source
Prices change. Check geiserx.github.io before you buy.
GenieACS FAQ
Does it talk to devices directly?
No. Everything goes through the GenieACS NBI, so unreachable devices fail the same way they do in the GenieACS UI.
Can I stop it from making changes?
Yes, set GENIEACS_READ_ONLY=true to serve only the two reading tools and the resources.
Does it store data?
No; the README says it has no database or cache of its own.
How do I try it without an ACS?
The README links a Docker Compose demo stack with a simulated router.
Which settings does it take?
ACS_URL, ACS_USER and ACS_PASS, plus DEVICE_LIMIT, ACS_TIMEOUT and ACS_MAX_RESPONSE_BYTES.
Is GenieACS free?
Yes. GenieACS is open source, so you can use and self-host it for free.
How do I add GenieACS to Claude Code?
Run this command in your terminal: claude mcp add genieacs-mcp --env ACS_PASS='<ACS_PASS>' -- npx -y genieacs-mcp
What are the best alternatives to GenieACS?
The closest alternatives to GenieACS are Agent Yurt, Proofline, filex, MagicWP MCP and Kubana Cloud Domains.
Alternatives to GenieACS

Agent Yurt
MCP serverBack up agent memory, files and dashboards, then recover from a reviewed snapshot
Not checked yet- Remote
- Free
- Knowledge and memory

Proofline
MCP serverProduction-aware review of changes against your AWS or Google Cloud setup, via MCP
- Remote
- Freemium
- Developer tools

filex
MCP serverSelf-hosted file manager in one Go binary with a built-in MCP server for agents
Not checked yet- Remote
- Open source
- Files and documents

MagicWP MCP
MCP serverRun WordPress hosting from an assistant: backups, staging, updates, PHP and domains
- Remote
- Free trial
- Cloud and infrastructure

Kubana Cloud Domains
MCP serverSearch, register and renew domains and set nameservers at Kubana Cloud from an assistant
Not checked yet- 3 tools
- Remote
- Paid
- Cloud and infrastructure

Kubana Cloud DNS Management
MCP serverCreate DNS zones, edit records and check nameserver delegation on Kubana Cloud
Not checked yet- 5 tools
- Remote
- Free
- Cloud and infrastructure