AsusWRT MCP server
✓ VerifiedLets an AI client monitor and manage AsusWRT and AsusWRT-Merlin routers via secure SSH commands.
Also known as teefloo/asuswrt-mcp
- Stars
- 3
- Tools
- 12
- Downloads, 30 days
- 158
- Latest version
- 0.1.1
- Last commit
- Apr 28, 2026
- License
- MIT
What is AsusWRT MCP?
AsusWRT lets an AI client monitor and manage AsusWRT and AsusWRT-Merlin routers via secure SSH commands. It exposes 12 tools, such as confirm, asuswrt_restart_service, asuswrt_dhcp_server.
Summary generated from the project's README
About AsusWRT MCP server
Managing AsusWRT or AsusWRT-Merlin routers through an AI assistant is possible with this MCP server. It provides a secure interface for developers and home administrators to monitor network health and adjust settings using SSH. The server connects to your router via SSH, requiring your host IP, username, and password or an SSH key file configured in your environment settings.
Monitoring is handled through 42 read-only tools that cover identity, network status, connected clients, wireless radio details, and VPN profiles. For making changes, the server includes mutation tools for tasks like restarting services, managing DHCP reservations, or toggling guest Wi-Fi. To prevent accidental changes, all mutations require the ASUSWRT_ALLOW_MUTATIONS environment variable to be set to true, an explicit confirmation parameter, and support for a dry run to preview the impact before execution.
What you can do with it
- 1Monitor network health and statusAsk your AI client to check the current router uptime, memory usage, and connected client list.
- 2Control parental access rulesHave the AI assistant block or unblock specific devices using parental control settings.
Written from the project's README. Every use case is checked against a quote from it.
How to install AsusWRT MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall AsusWRT MCP in Claude Code
$ claude mcp add --env 'ASUSWRT_SSH_PASSWORD=<YOUR_ASUSWRT_SSH_PASSWORD>' --env 'ASUSWRT_HOST=<ASUSWRT_HOST>' --env 'ASUSWRT_SSH_USERNAME=<ASUSWRT_SSH_USERNAME>' asuswrt-mcp -- uvx asuswrt-mcpInstall AsusWRT MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"asuswrt-mcp": {
"command": "uvx",
"args": [
"asuswrt-mcp"
],
"env": {
"ASUSWRT_SSH_PASSWORD": "<YOUR_ASUSWRT_SSH_PASSWORD>",
"ASUSWRT_HOST": "<ASUSWRT_HOST>",
"ASUSWRT_SSH_USERNAME": "<ASUSWRT_SSH_USERNAME>"
}
}
}
}Install AsusWRT MCP in VS Code
.vscode/mcp.json
{
"servers": {
"asuswrt-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"asuswrt-mcp"
],
"env": {
"ASUSWRT_SSH_PASSWORD": "<YOUR_ASUSWRT_SSH_PASSWORD>",
"ASUSWRT_HOST": "<ASUSWRT_HOST>",
"ASUSWRT_SSH_USERNAME": "<ASUSWRT_SSH_USERNAME>"
}
}
}
}Install AsusWRT MCP in VS Code CLI
$ code --add-mcp '{"name":"asuswrt-mcp","type":"stdio","command":"uvx","args":["asuswrt-mcp"],"env":{"ASUSWRT_SSH_PASSWORD":"<YOUR_ASUSWRT_SSH_PASSWORD>","ASUSWRT_HOST":"<ASUSWRT_HOST>","ASUSWRT_SSH_USERNAME":"<ASUSWRT_SSH_USERNAME>"}}'Install AsusWRT MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"asuswrt-mcp": {
"command": "uvx",
"args": [
"asuswrt-mcp"
],
"env": {
"ASUSWRT_SSH_PASSWORD": "<YOUR_ASUSWRT_SSH_PASSWORD>",
"ASUSWRT_HOST": "<ASUSWRT_HOST>",
"ASUSWRT_SSH_USERNAME": "<ASUSWRT_SSH_USERNAME>"
}
}
}
}Install AsusWRT MCP in Codex
$ codex mcp add asuswrt-mcp --env 'ASUSWRT_SSH_PASSWORD=<YOUR_ASUSWRT_SSH_PASSWORD>' --env 'ASUSWRT_HOST=<ASUSWRT_HOST>' --env 'ASUSWRT_SSH_USERNAME=<ASUSWRT_SSH_USERNAME>' -- uvx asuswrt-mcpInstall AsusWRT MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.asuswrt-mcp] command = "uvx" args = ["asuswrt-mcp"] [mcp_servers.asuswrt-mcp.env] ASUSWRT_SSH_PASSWORD = "<YOUR_ASUSWRT_SSH_PASSWORD>" ASUSWRT_HOST = "<ASUSWRT_HOST>" ASUSWRT_SSH_USERNAME = "<ASUSWRT_SSH_USERNAME>"
Install AsusWRT MCP in Gemini CLI
$ gemini mcp add -s user -e 'ASUSWRT_SSH_PASSWORD=<YOUR_ASUSWRT_SSH_PASSWORD>' -e 'ASUSWRT_HOST=<ASUSWRT_HOST>' -e 'ASUSWRT_SSH_USERNAME=<ASUSWRT_SSH_USERNAME>' asuswrt-mcp uvx -- asuswrt-mcpInstall AsusWRT MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"asuswrt-mcp": {
"command": "uvx",
"args": [
"asuswrt-mcp"
],
"env": {
"ASUSWRT_SSH_PASSWORD": "<YOUR_ASUSWRT_SSH_PASSWORD>",
"ASUSWRT_HOST": "<ASUSWRT_HOST>",
"ASUSWRT_SSH_USERNAME": "<ASUSWRT_SSH_USERNAME>"
}
}
}
}AsusWRT MCP tools 12
Detected from the READMEconfirmasuswrt_restart_serviceasuswrt_dhcp_serverasuswrt_upnpasuswrt_radioasuswrt_guest_wifiasuswrt_guest_lan_accessasuswrt_port_forwardingasuswrt_vpn_serverasuswrt_parental_accessasuswrt_parental_block_allasuswrt_dhcp_reservation
Configuration
ASUSWRT_SSH_PASSWORDRequiredSecretSSH password for router authentication
ASUSWRT_HOSTRequiredRouter IP address (e.g., 192.168.1.1)
ASUSWRT_SSH_USERNAMERequiredSSH username for router authentication
ASUSWRT_ALLOW_MUTATIONSEnable mutation tools (default: false)
ASUSWRT_SSH_KEY_FILEPath to SSH private key file (alternative to password)
ASUSWRT_TEST_ROUTER
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableteefloo/asuswrt-mcp is public and reachablegithub.com/teefloo/asuswrt-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-04-28github.com/teefloo/asuswrt-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from asuswrt-mcpPass
- No critical advisory in the package or its dependencies44 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubAsusWRT MCP Server
mcp-name: io.github.teefloo/asuswrt-mcp
Model Context Protocol (MCP) server for secure, controlled administration of AsusWRT and AsusWRT-Merlin routers via SSH.
Overview
This MCP server provides AI assistants (like Claude, Cursor, etc.) with a safe interface to monitor and manage AsusWRT routers. It operates exclusively over SSH using allowlisted operations—no arbitrary command execution, no firmware modifications, and no factory resets.
Features
Read-Only Monitoring (42 tools)
| Category | Tools |
|---|---|
| Identity & Health | Router model, firmware version, uptime, load, memory |
| Network | LAN/WAN details, DNS config, IPv6 status, routing table |
| Clients | Connected clients, DHCP leases, ARP neighbors |
| Wireless | Radio status, SSIDs, guest networks, client counts per band |
| Services | Running processes, open ports, cron jobs |
| Storage | USB devices, mounts, partitions, filesystem usage |
| Security | UPnP, DDNS, Samba status, conntrack usage |
| VPN | OpenVPN server, WireGuard, VPN client profiles |
| Administration | Web admin ports, SSH/telnet access settings |
| Diagnostics | SSH TCP/banner/auth diagnostics, config snapshot |
Mutation Tools (with safety guards)
All mutation tools require:
confirm: trueparameterASUSWRT_ALLOW_MUTATIONS=trueenvironment variable- Support for
dry_run: trueto preview changes
| Tool | Description |
|---|---|
asuswrt_restart_service |
Restart allowlisted services (httpd, firewall, wireless, dnsmasq, etc.) |
asuswrt_dhcp_server |
Enable/disable DHCP server |
asuswrt_upnp |
Enable/disable UPnP |
asuswrt_radio |
Enable/disable Wi-Fi radio bands |
asuswrt_guest_wifi |
Enable/disable guest Wi-Fi |
asuswrt_guest_lan_access |
Toggle LAN access for guest Wi-Fi |
asuswrt_port_forwarding |
List, add, remove, enable/disable port forwarding rules |
asuswrt_vpn_server |
Enable/disable OpenVPN server |
asuswrt_parental_access |
List, block, unblock, remove parental control rules |
asuswrt_parental_block_all |
Toggle block-all mode |
asuswrt_dhcp_reservation |
List, add, remove DHCP static reservations |
Safety Model
- No arbitrary SSH: Only allowlisted commands are executed via NVRAM and service calls
- No firmware operations: No flash, reset, or bootloader access
- Secret redaction: Passwords and sensitive data are never exposed in tool responses
- Dry-run support: Every mutation can be previewed before applying
- Confirmation required: Mutations require explicit
confirm=True - SSH-only transport: No exposure of the router's web API
Prerequisites
- Python 3.11+
- An AsusWRT or AsusWRT-Merlin router with SSH access enabled
- Network connectivity from the MCP client to the router
Installation
1. Clone and setup
git clone https://github.com/Teeflo/asuswrt-mcp.git
cd asuswrt-mcp
# Create virtual environment
python -m venv .venv
# Activate (Linux/macOS)
source .venv/bin/activate
# Activate (Windows)
.venv\Scripts\activate
# Install dependencies
pip install -e .
2. Configure environment
# Copy example configuration
cp .env.example .env
# Edit with your router credentials
# Use your favorite editor:
notepad .env # Windows
nano .env # Linux/macOS
3. Configure .env
# Required: Router connection
ASUSWRT_HOST=192.168.1.1
ASUSWRT_SSH_USERNAME=admin
ASUSWRT_SSH_PASSWORD=your_password
# Optional: SSH key authentication
# ASUSWRT_SSH_KEY_FILE=~/.ssh/id_rsa
# Optional: Enable mutations (disabled by default)
# ASUSWRT_ALLOW_MUTATIONS=true
# Optional: Connection settings
# ASUSWRT_SSH_PORT=22
# ASUSWRT_TIMEOUT_SECONDS=10
Usage
Run the MCP server
# Standard stdio mode
python -m asuswrt_mcp.server
# Or use the entry point
asuswrt-mcp
Configure in Claude Desktop / Cursor
Add to your claude_desktop_config.json:
{
"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"
}
}
}
}
Using with npx Inspector (development)
npx @modelcontextprotocol/inspector python -m asuswrt_mcp.server
Development
Run tests
pip install -e ".[dev]"
pytest
Run with live router integration tests
ASUSWRT_TEST_ROUTER=1 pytest
Project Structure
asuswrt-mcp/
├── src/asuswrt_mcp/
│ ├── server.py # FastMCP entrypoint & tool definitions
│ ├── service.py # Business logic & router operations
│ ├── config.py # Settings management
│ ├── clients/
│ │ └── ssh.py # SSH client wrapper
│ ├── nvram.py # NVRAM parsing utilities
│ ├── ssh_parsers.py # Output parsers for SSH commands
│ ├── security.py # Mutation guards & redaction
│ ├── validators.py # Input validation
│ ├── responses.py # Tool response formatting
│ ├── errors.py # Custom exceptions
│ └── serialization.py # Safe serialization
├── tests/ # Test suite (69 tests)
├── .env.example # Example configuration
├── pyproject.toml # Project metadata
└── README.md # This file
License
MIT License - see LICENSE for details.
Acknowledgments
- asusrouter for the underlying Python library
- MCP for the protocol specification
- AsusWRT-Merlin for the firmware
AsusWRT MCP questions
How do I add AsusWRT MCP to Claude Code?
Run claude mcp add --env 'ASUSWRT_SSH_PASSWORD=<YOUR_ASUSWRT_SSH_PASSWORD>' --env 'ASUSWRT_HOST=<ASUSWRT_HOST>' --env 'ASUSWRT_SSH_USERNAME=<ASUSWRT_SSH_USERNAME>' asuswrt-mcp -- uvx asuswrt-mcp in your terminal. Add --scope user to make it available in every project.
How do I add AsusWRT MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does AsusWRT MCP provide?
It exposes 12 tools, including confirm, asuswrt_restart_service, asuswrt_dhcp_server, asuswrt_upnp, asuswrt_radio.
Can the AI execute arbitrary commands on my router?
No, the server only allows specific, allowlisted operations via NVRAM and service calls to ensure security.
How can I safely test changes to my router settings?
You can use the dry_run parameter to preview changes before they are applied.