Genieacs MCP Server

@GeiserX

Repository

Basic information

About Genieacs MCP Server

MCP Server for GenieACS written in Go

#golang #mcp#genieacs

Genieacs MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "genieacs": {
      "command": "npx",
      "args": [
        "-y",
        "genieacs-mcp"
      ],
      "env": {
        "ACS_URL": "http://localhost:7557",
        "ACS_USER": "",
        "ACS_PASS": ""
      }
    }
  }
}

Genieacs MCP Server tools

Push a firmware (or any file) to a device

Reboot a CPE via GenieACS

Ask the CPE to send an updated value for a single TR-069 parameter

Overview

What is Genieacs Mcp?

A tiny bridge that exposes any GenieACS instance as an MCP v1 (JSON-RPC for LLMs) server written in Go. It allows LLM agents to interact with a GenieACS TR-069 Auto-Configuration-Server (ACS) that manages CPE devices such as routers, ONTs, and gateways. The server exposes GenieACS data as resources (read‑only) and actions as tools (read/write, reboot, etc.).

How to use Genieacs Mcp?

Use the quick‑start Docker Compose file from the GenieACS‑container project or install via npm (npx genieacs-mcp). Configure via environment variables such as ACS_URL, ACS_USER, ACS_PASS, and TRANSPORT. It supports both HTTP and stdio transports; the stdio transport is recommended for local MCP clients.

Key features of Genieacs Mcp

Exposes GenieACS data as read‑only MCP resources
Provides tools for parameter read/write, reboot, and firmware download
Supports preset, provision, tag, and task management
Offers device search by criteria
Runs as a single Go binary with minimal dependencies
Supports HTTP and stdio transports with security headers validation

Use cases of Genieacs Mcp

Reboot a faulty CPE device via an LLM conversation
Query device parameters and fault information for diagnostics
Automate preset or provision assignments across a device fleet
Search for devices by model or status and apply tags
Manage firmware download and task retries through natural language

Frequently asked questions

What dependencies does Genieacs Mcp require?

It requires a running GenieACS instance with its NBI endpoint accessible. No other runtime dependencies; the pre‑built Go binary is self‑contained.

How does Genieacs Mcp handle security?

The HTTP transport validates `Host` and `Origin` headers to prevent DNS rebinding. A Bearer token (`MCP_AUTH_TOKEN`) is required when listening on non‑loopback addresses. The stdio transport is unaffected and recommended for local use.

What transports does Genieacs Mcp support?

It supports HTTP (default) and stdio. Set the `TRANSPORT` environment variable to `stdio` to use the stdio transport for local MCP clients.

What is the maximum number of devices returned by a resource?

The `DEVICE_LIMIT` environment variable sets the maximum devices returned by the `genieacs://devices/list` resource, defaulting to 500.

What data does Genieacs Mcp expose as resources?

It provides resources for individual devices, files, tasks, and lists of devices, presets, provisions, and faults,

Comments

More Other MCP servers

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi