What is GenieACS and how does this MCP server connect to it?

GenieACS is a TR-069 ACS (Auto Configuration Server) for managing CPE (Customer Premises Equipment) devices. This MCP server bridges GenieACS's NBI (North Bound Interface) API to LLMs, allowing you to query and manage devices via natural language through Claude or similar models.

How do I authenticate with my GenieACS instance?

Set the required ACS_URL environment variable to your GenieACS NBI API endpoint (e.g., http://genieacs:7557), and optionally provide ACS_USER and ACS_PASS for basic authentication if your instance requires credentials.

Can I use this server without a GenieACS deployment?

No, this server requires an active GenieACS instance with an accessible NBI API. You must have GenieACS running and the ACS_URL configured before the MCP server can function.

What TR-069 operations can I perform through this MCP server?

The server exposes GenieACS NBI capabilities, which typically include querying device parameters, triggering provisioning tasks, and retrieving device inventory and status. Refer to your GenieACS NBI API documentation for the full set of supported operations.

Is there a cost or licensing requirement for this MCP server?

This MCP server itself is open-source (npm package genieacs-mcp). GenieACS is also open-source, though you are responsible for hosting and maintaining your own GenieACS instance and any associated infrastructure.

MCP ServerSTDIOOfficialv0.0.12

Geiserx Genieacs MCP Server

Manage CPE devices and TR-069 ACS instances through an LLM interface by bridging GenieACS to Claude or other AI models. Enables automated device provisioning, parameter queries, and bulk operations on your GenieACS deployment.

io.github.GeiserX/genieacs-mcp

Try MCP with AI models View source

Hosted URL

Local install

Transport

STDIO

Auth

2 required env vars

What the Geiserx Genieacs MCP server does

How models use it and what it is built for.

Connect to Geiserx Genieacs

Local install — runs as a subprocess.

npx genieacs-mcp@0.0.11

Environment variables

Configuration this server reads at startup.

ACS_URLRequired
GenieACS NBI API URL (e.g. http://genieacs:7557)
ACS_URLRequired
GenieACS NBI API URL (e.g. http://genieacs:7557)
ACS_USER
GenieACS NBI basic-auth username
ACS_PASSSecret
GenieACS NBI basic-auth password
ACS_USER
GenieACS NBI basic-auth username
ACS_PASSSecret
GenieACS NBI basic-auth password

Resources

Where to find authoritative docs and source for Geiserx Genieacs.

Source repository

Example prompts for Geiserx Genieacs

Paste any of these into Agent Studio after connecting Geiserx Genieacs.

List all CPE devices currently connected to the GenieACS instance
Query the WAN IP address parameter for device with serial XYZ123
Show me devices that failed their last provisioning task
What authentication methods does the GenieACS NBI API support?

Geiserx Genieacs MCP server — FAQ

Common questions about connecting and running Geiserx Genieacs.

What is GenieACS and how does this MCP server connect to it?
GenieACS is a TR-069 ACS (Auto Configuration Server) for managing CPE (Customer Premises Equipment) devices. This MCP server bridges GenieACS's NBI (North Bound Interface) API to LLMs, allowing you to query and manage devices via natural language through Claude or similar models.
How do I authenticate with my GenieACS instance?
Set the required ACS_URL environment variable to your GenieACS NBI API endpoint (e.g., http://genieacs:7557), and optionally provide ACS_USER and ACS_PASS for basic authentication if your instance requires credentials.
Can I use this server without a GenieACS deployment?
No, this server requires an active GenieACS instance with an accessible NBI API. You must have GenieACS running and the ACS_URL configured before the MCP server can function.
What TR-069 operations can I perform through this MCP server?
The server exposes GenieACS NBI capabilities, which typically include querying device parameters, triggering provisioning tasks, and retrieving device inventory and status. Refer to your GenieACS NBI API documentation for the full set of supported operations.
Is there a cost or licensing requirement for this MCP server?
This MCP server itself is open-source (npm package genieacs-mcp). GenieACS is also open-source, though you are responsible for hosting and maintaining your own GenieACS instance and any associated infrastructure.

Skip the local setup — run MCP in your browser

MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 40+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.

Open Agent Studio