# GenieACS

> GenieACS is an open-source MCP server for cloud and infrastructure. MCP server that lets an AI client read and manage GenieACS TR-069 devices. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://geiserx.github.io/genieacs-mcp/
- **Repository:** https://github.com/geiserx/genieacs-mcp
- **MCP Registry name:** io.github.GeiserX/genieacs-mcp
- **Categories:** cloud and infrastructure
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add genieacs-mcp --env ACS_PASS='<ACS_PASS>' -- npx -y genieacs-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "genieacs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "genieacs-mcp"
      ],
      "env": {
        "ACS_PASS": "<ACS_PASS>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "genieacs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "genieacs-mcp"
      ],
      "env": {
        "ACS_PASS": "<ACS_PASS>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "genieacs-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "genieacs-mcp"
      ],
      "env": {
        "ACS_PASS": "<ACS_PASS>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "genieacs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "genieacs-mcp"
      ],
      "env": {
        "ACS_PASS": "<ACS_PASS>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "genieacs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "genieacs-mcp"
      ],
      "env": {
        "ACS_PASS": "<ACS_PASS>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.
- [Proofline](https://ai-powered.com/mcp/proofline): Proofline is a freemium MCP server for developer tools.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [MagicWP MCP](https://ai-powered.com/mcp/magicwp-mcp): MagicWP MCP is an MCP server for cloud and infrastructure.
- [Kubana Cloud Domains](https://ai-powered.com/mcp/kubana-cloud-domains): Kubana Cloud Domains is a paid MCP server for cloud and infrastructure.
- [Kubana Cloud DNS Management](https://ai-powered.com/mcp/kubana-cloud-dns-management): Kubana Cloud DNS Management is a free MCP server for cloud and infrastructure.
- [Kubana Cloud VPS](https://ai-powered.com/mcp/kubana-cloud-vps): Kubana Cloud VPS is a paid MCP server for cloud and infrastructure.
- [AgentViva](https://ai-powered.com/mcp/agentviva): AgentViva is a free MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/genieacs
