Genieacs MCP Server

by geiserxio.github.GeiserX/genieacs-mcpv0.3.4

Bridge to GenieACS (TR-069 ACS) instances: device data, firmware management and CPE actions such as reboot, parameter refresh and firmware download.

18Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active4d ago

Install Genieacs MCP server

claude mcp add genieacs -e ACS_URL='<acs-url>' -e ACS_PASS='<acs-pass>' -- npx -y genieacs-mcp

{
  "mcpServers": {
    "genieacs": {
      "command": "npx",
      "args": [
        "-y",
        "genieacs-mcp"
      ],
      "env": {
        "ACS_URL": "<acs-url>",
        "ACS_PASS": "<acs-pass>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "genieacs": {
      "command": "npx",
      "args": [
        "-y",
        "genieacs-mcp"
      ],
      "env": {
        "ACS_URL": "<acs-url>",
        "ACS_PASS": "<acs-pass>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "genieacs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "genieacs-mcp"
      ],
      "env": {
        "ACS_URL": "<acs-url>",
        "ACS_PASS": "<acs-pass>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "genieacs": {
      "command": "npx",
      "args": [
        "-y",
        "genieacs-mcp"
      ],
      "env": {
        "ACS_URL": "<acs-url>",
        "ACS_PASS": "<acs-pass>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
ACS_URL	yes	—	GenieACS NBI API URL (e.g. http://genieacs:7557)
ACS_USER	—	—	GenieACS NBI basic-auth username
ACS_PASS	—	yes	GenieACS NBI basic-auth password
DEVICE_LIMIT	—	—	Max devices returned by genieacs://devices/list (default 500)

Freshness

Active — last maintenance signal 4d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-05 · 4d ago · GitHub
Latest release
2026-10-04 · 5d ago · GitHub · v0.3.4
Package published
no data · npm/PyPI
Registry entry updated
2026-10-05 · 4d ago · official registry · v0.3.4

FAQ

›How do I install the Genieacs MCP server in Claude Code?

Run: claude mcp add genieacs -e ACS_URL='<acs-url>' -e ACS_PASS='<acs-pass>' -- npx -y genieacs-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Genieacs require an API key?

Yes. It expects ACS_URL, ACS_PASS, of which 1 is a secret.

›Can I use Genieacs as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Genieacs in the official MCP registry?

Yes, as io.github.GeiserX/genieacs-mcp.