Genieacs Mcp

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

FAQ from Genieacs Mcp

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,