MCP.so
Sign In
A

Asuswrt Mcp Server

@teefloo

About Asuswrt Mcp Server

Model Context Protocol server for secure AsusWRT router administration via SSH. Provides 42+ read-only monitoring tools and guarded mutation tools for managing AsusWRT/Merlin routers

Basic information

Config

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

{
  "mcpServers": {
    "asuswrt-mcp": {
      "command": "C:\\path\\to\\asuswrt-mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "-m",
        "asuswrt_mcp.server"
      ],
      "env": {
        "ASUSWRT_HOST": "192.168.1.1",
        "ASUSWRT_SSH_USERNAME": "admin",
        "ASUSWRT_SSH_PASSWORD": "your_password"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Asuswrt Mcp Server?

A Model Context Protocol server that provides AI assistants with a secure, controlled interface to monitor and manage AsusWRT and AsusWRT-Merlin routers exclusively over SSH using allowlisted operations.

How to use Asuswrt Mcp Server?

Install with Python 3.11+, configure the .env file with router SSH credentials, then run python -m asuswrt_mcp.server or configure it in Claude Desktop / Cursor via claude_desktop_config.json. Mutations require setting ASUSWRT_ALLOW_MUTATIONS=true and passing confirm: true.

Key features of Asuswrt Mcp Server

  • 42 read-only monitoring tools for router health, network, clients, and services
  • 11 mutation tools with safety guards and dry-run preview
  • No arbitrary SSH execution — only allowlisted NVRAM and service calls
  • Secret redaction prevents passwords from appearing in tool responses
  • SSH-only transport with no exposure of the router's web API

Use cases of Asuswrt Mcp Server

  • Monitor router uptime, connected clients, and wireless status via an AI assistant
  • Safely restart router services like dnsmasq, firewall, or wireless
  • Manage DHCP reservations, port forwarding rules, and parental controls
  • Toggle Wi-Fi radios, guest networks, VPN servers, and UPnP state
  • Diagnose router configuration by inspecting SSH, admin ports, and routing tables

FAQ from Asuswrt Mcp Server

What routers are supported?

AsusWRT and AsusWRT-Merlin routers with SSH access enabled.

What are the runtime requirements?

Python 3.11+ is required, and network connectivity from the MCP client to the router.

How does the safety model work?

Only allowlisted commands are executed via NVRAM and service calls. No arbitrary SSH, firmware operations, factory resets, or bootloader access is allowed.

How do I enable mutation tools?

Set the ASUSWRT_ALLOW_MUTATIONS=true environment variable and pass confirm: true in each mutation call. Dry-run is also supported with dry_run: true.

How is the server installed?

Clone the repository, create a Python virtual environment, install with pip install -e ., copy .env.example to .env, and configure router credentials.

Comments

More Developer Tools MCP servers