Skip to content
MCP server

GenieACS

MCP server that lets an AI client read and manage GenieACS TR-069 devices

Runs locallyStatus and history
Install
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-mcp

Add 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 slash
  • ACS_USERGenieACS NBI basic-auth username
  • ACS_PASSGenieACS NBI basic-auth password
  • DEVICE_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 ACS
  • GENIEACS_TOOLSComma-separated tool names to serve; every other tool is left out
  • ACS_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 slash
  • ACS_USERGenieACS NBI basic-auth username
  • ACS_PASSGenieACS NBI basic-auth password
  • DEVICE_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 ACS
  • GENIEACS_TOOLSComma-separated tool names to serve; every other tool is left out
  • ACS_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

  1. Agent Yurt

    MCP server

    Back up agent memory, files and dashboards, then recover from a reviewed snapshot

    Not checked yet
    • Remote
    • Free
    • Knowledge and memory
  2. Proofline

    MCP server

    Production-aware review of changes against your AWS or Google Cloud setup, via MCP

    • Remote
    • Freemium
    • Developer tools
  3. filex

    MCP server

    Self-hosted file manager in one Go binary with a built-in MCP server for agents

    Not checked yet
    • Remote
    • Open source
    • Files and documents
  4. MagicWP MCP

    MCP server

    Run WordPress hosting from an assistant: backups, staging, updates, PHP and domains

    • Remote
    • Free trial
    • Cloud and infrastructure
  5. Search, register and renew domains and set nameservers at Kubana Cloud from an assistant

    Not checked yet
    • 3 tools
    • Remote
    • Paid
    • Cloud and infrastructure
  6. Create DNS zones, edit records and check nameserver delegation on Kubana Cloud

    Not checked yet
    • 5 tools
    • Remote
    • Free
    • Cloud and infrastructure