Skip to main content
Glama

jooservices/vigor3912s-mcp

CI E2E OpenSSF Scorecard Node License: MIT Version

MCP server (Model Context Protocol) for a DrayTek Vigor 3912S router (DrayOS) over SSH.

Covers the CLI command set as MCP tools (666 tools / 43 families), driven by @jooservices/vigor3912s-sdk + @jooservices/ssh-client:

  • Read commands (220) run freely when exposed — curated reads plus auto-registered SDK ops with a schema-derived arg surface (sdk_generated).

  • Write commands (446) require a two-step Ed25519 confirm gate (preview → signed approval) before execution. Dual-tier writes also need acknowledge: true.

Status

v2.0.1 — local stdio MCP server for trusted LAN use; hosted on jooservices/vigor3912s-mcp.

The registry contains 666 tools across 43 families (220 read / 446 write); 663 use the SDK and three reviewed compatibility tools use the raw command path. Local deployments expose only read tools by default. Set EXPOSE_TOOLS=all explicitly to expose the full catalog. Write tools are exercised in CI against a simulated DrayOS server (npm run e2e:testing).

Upgrade from 1.x: see the 2.0 migration guide.

Related MCP server: Keenetic NOC MCP

Documentation

Safety model

  • SSH host-key pin — set VIGOR_SSH_HOST_FINGERPRINT (required). Use VIGOR_SSH_INSECURE_SKIP_VERIFY=true only for tests / simulated DrayOS.

  • Read tools — unit tests (mocked transport) and local real-router E2E (npm run e2e with EXPOSE_TOOLS=readonly).

  • Write tools — unit tests with a mocked client; CI E2E exercises confirmed writes only against the simulated DrayOS server (npm run e2e:testing). A write executes only after Ed25519 signed approval.

  • Confirm gate — single-use 60s intent bound to the command digest; human signs with a private key (tools/approve.mjs); MCP verifies VIGOR_APPROVE_PUBKEY.

  • Dangerous writes — additionally require acknowledge: true and return a lockout warning (policy in src/commands/tool-policy.ts).

  • Auto-commit — after a successful confirmed write, sys commit runs (VIGOR_AUTO_COMMIT; skipped for skipCommit). Outcome in write_audit.commit_status.

  • Command mutex — commands are serialized on the shared SSH shell; writes use an exclusive confirm→execute lock.

  • Hard blocklist — sys cfg default, sys halt, mngt rmtcfg enable, linux clean * refused regardless of the registry.

  • Tool filters — EXPOSE_TOOLS / VIGOR_DISABLED_TOOLS; read output capped via VIGOR_TOOL_OUTPUT_LIMIT.

  • Injection guards — shared Zod validators (safeText / noControl / ipv4Mask, …) aligned with SDK command framing.

  • Credentials live only in .env (chmod 600, gitignored); secret args are redacted in SQLite logs and pending confirm files (0600).

Architecture

opencode ←stdio→ MCP server (Node 24 + TypeScript)
                        │ @jooservices/vigor3912s-sdk + ssh-client
                        ▼
                DrayOS CLI @ <VIGOR_HOST>  (prompt `DrayTek> `)

Layer

Role

src/commands/registry/

CLI catalog by family (R / Ra / W) + schema-generated SDK tools

src/commands/validators.ts

Shared Zod arg schemas

src/commands/tool-policy.ts

Confirm tiers / secret fields / sensitive output / snapshots

src/commands/write-executor.ts

Sign-gated confirm → snapshot → execute → commit → audit

src/commands/build.ts

MCP tool registration

src/commands/read-allowlist.ts

Registry-derived allowlist for runCommand()

src/ssh/sdk-vigor-client.ts

SDK client + SshClientTransport

DrayOS SSH does not support the exec channel or key auth — password auth and an interactive shell only.

Tools

Every registry command becomes an MCP tool:

  • Read tools (220) — run the CLI and return output (structured when a formatter exists). Formatters receive validated args (e.g. ip_ping target).

  • Write tools (446) — first call returns a redacted preview + confirmation_id / sign_payload; second call requires signature (and acknowledge: true for dual-tier tools).

When a write includes secret fields, its preview uses named markers such as <redacted:param> and returns redacted_fields. Approving that intent prompts for each value with input hidden; the CLI signs only if the re-entered values rebuild the exact command digest. Secret values are not saved in the pending intent. It refuses this flow without an interactive TTY. Raw payload signing is an explicit blind bypass: node tools/approve.mjs --payload <file|-> --blind prints a warning.

Tool

CLI (live-verified, fw 4.4.7_RC2)

sys_version

sys version

show_status

show status

wan_status

wan status

show_lan

show lan

ip_route_status

ip route status

ip_arp_status

ip arp status

dhcp_status

srv dhcp status

ip_ping

ip ping <ipv4> (5 packets)

internet_set

internet -W <n> -M <mode> [-S ispName] (write; signed)

Requirements

Component

Requirement

Node.js

>= 24.21.0 and < 25 (package.json engines / .nvmrc)

npm

>= 12.0.2 and < 13 (SDK package engine)

@jooservices/ssh-client

>= 1.3.0; CI defaults to v1.3.0

@jooservices/vigor3912s-sdk

>= 2.0.0; CI defaults to v2.0.0

Install layout

Sibling packages at ../ssh-client and ../vigor3912s-sdk for local/CI file: dependencies

Router

Vigor 3912S with SSH enabled and reachable on the LAN

Credentials

Admin password and pinned SSH host fingerprint in .env

Write approvals

Ed25519 approve public key; not required when VIGOR_READ_ONLY=true

Setup

cp .env.example .env
# Set VIGOR_HOST / VIGOR_PORT / VIGOR_USER / VIGOR_PASSWORD
# Pin the host key (required for live routers):
ssh-keyscan -t rsa,ecdsa,ed25519 "$VIGOR_HOST" 2>/dev/null | ssh-keygen -lf - -E sha256
# → put the SHA256:… value in VIGOR_SSH_HOST_FINGERPRINT
# Generate approve keys for writes:
node tools/approve-keygen.mjs
# → set VIGOR_APPROVE_PUBKEY from the printed value / public PEM
# Default exposure is readonly; opt in to all 666 tools with:
# EXPOSE_TOOLS=all
chmod 600 .env
npm install
npm run build

Register in opencode

Add to opencode.json (project or global):

{
  "mcp": {
    "vigor3912s": {
      "type": "local",
      "command": ["node", "/abs/path/to/vigor3912s-mcp/dist/index.js"],
      "cwd": "/abs/path/to/vigor3912s-mcp",
      "enabled": true
    }
  }
}

Restart opencode, then: get the WAN status from the router.

Logging (SQLite)

Every router request is logged to data/vigor3912s.db (or VIGOR_LOG_DB, WAL):

  • requests — tool, CLI, args, outcome, timing, output excerpt

  • write_audit — preview / executed / failed / expired / mismatch / denied, optional before/after snapshots, commit_status

Passwords and configured secretArgs are redacted to *** in argument logs; secret command values use named placeholders in approval previews. Logging is best-effort and never blocks a router command.

sqlite3 data/vigor3912s.db "SELECT ts, tool_id, command, outcome FROM requests ORDER BY id DESC LIMIT 20;"
sqlite3 data/vigor3912s.db "SELECT ts, tool_id, status, success FROM write_audit ORDER BY id DESC LIMIT 20;"

Development

npm run lint        # tsc --noEmit
npm test            # unit tests (mocked transport; no router)
npm run e2e         # tools vs target in .env (use EXPOSE_TOOLS=readonly locally)
npm run e2e:testing # full tool surface + confirmed writes vs simulated DrayOS (CI)

Security

See SECURITY.md for the threat model, live-router ops (Ed25519 approve / readonly), and accepted risks (noControl passwords, internal sys commit after a gated write).

  • Never weaken the driver allowlist/blocklist or the confirm gate.

  • Do not set VIGOR_SSH_INSECURE_SKIP_VERIFY=true against a live router on an untrusted LAN.

Available Tools

217 tools
apm_disableB

Disable AP management (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

apm_enableC

Enable AP management (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

apm_queryC

AP query (read-only)

Inputs: no named parameters.

apm_showB

AP management status (read-only)

Inputs: no named parameters.

apm_stanumB

AP station number (read-only)

Inputs: no named parameters.

appqos_enableB

Enable/disable APP QoS (write — requires confirmation)

Inputs: mode (required), user_code, confirm_token, confirmation_id.

appqos_viewA

APP QoS profile view (read-only)

Inputs: no named parameters.

csm_appe_setB

Set APP enforcement profile (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

csm_appe_showB

APP enforcement profile view (read-only)

Inputs: no named parameters.

csm_dnsfC

DNS filter settings (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

csm_ucfC

URL content filter settings (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

csm_wcfC

Web content filter settings (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

ddns_enableB

Enable/disable DDNS (write — requires confirmation)

Inputs: onoff (required), user_code, confirm_token, confirmation_id.

ddns_forceupdateC

Force DDNS update (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

ddns_logC

DDNS log (read-only)

Inputs: no named parameters.

ddns_showC

DDNS configuration (read-only)

Inputs: no named parameters.

dhcp_dns1B

Set DHCP primary DNS (write — requires confirmation)

Inputs: dns (required), lan (required), user_code, confirm_token, +1 more.

dhcp_dns2B

Set DHCP secondary DNS (write — requires confirmation)

Inputs: dns (required), lan (required), user_code, confirm_token, +1 more.

dhcp_gatewayC

Set DHCP pool gateway (write — requires confirmation)

Inputs: lan (required), gateway (required), user_code, confirm_token, +1 more.

dhcp_leasetimeB

Set DHCP lease time (write — requires confirmation)

Inputs: lan (required), seconds (required), user_code, confirm_token, +1 more.

dhcp_offA

Disable DHCP server (requires reboot to apply) (write — requires confirmation)

Inputs: user_code, acknowledge, confirm_token, confirmation_id.

dhcp_onA

Enable DHCP server (requires reboot to apply) (write — requires confirmation)

Inputs: user_code, acknowledge, confirm_token, confirmation_id.

dhcp_startipB

Set DHCP start IP and pool count (write — requires confirmation)

Inputs: lan (required), count (required), start (required), user_code, +2 more.

dhcp_statusA

DHCP server status + lease/reservation table (read-only)

Inputs: no named parameters.

dos_activateC

Activate DoS defense system (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

dos_blacklist_showA

Show DoS blocking list (read-only)

Inputs: no named parameters.

dos_deactivateC

Deactivate DoS defense system (write — requires confirmation)

Inputs: user_code, acknowledge, confirm_token, confirmation_id.

dos_viewA

View DoS defense configuration (read-only)

Inputs: no named parameters.

dos_whitelist_showA

Show DoS passing (white) list (read-only)

Inputs: no named parameters.

dpdk_cmdlogC

DPDK command log (read-only)

Inputs: no named parameters.

dpdk_statisticB

DPDK statistics (read-only)

Inputs: no named parameters.

fs_infoC

File system info (read-only)

Inputs: no named parameters.

fs_lsB

List router file system (read-only)

Inputs: no named parameters.

fs_pwdA

Print working directory (read-only)

Inputs: no named parameters.

ha_setC

Configure HA (write — requires confirmation)

Inputs: param (required), user_code, acknowledge, confirm_token, +1 more.

ha_showB

HA configuration (read-only)

Inputs: no named parameters.

ha_statusB

HA status (read-only)

Inputs: no named parameters.

hsportal_infoB

Hotspot portal info (read-only)

Inputs: no named parameters.

hsportal_levelB

Hotspot portal level (read-only)

Inputs: no named parameters.

hsportal_setupB

Configure hotspot portal (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

internet_setA

Set WAN internet access mode (PPPoE/DHCP/static/...) (write — requires confirmation)

Inputs: wan (required), mode (required), password, username, +4 more.

internet_viewB

View Internet access profile (read-only)

Inputs: no named parameters.

ip6_addrB

Configure an IPv6 address (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

ip6_mngtB

Enable/disable IPv6 management for a protocol (write — requires confirmation)

Inputs: onoff (required), proto (required), user_code, confirm_token, +1 more.

ip6_pingA

Ping an IPv6 host (read-only)

Inputs: host (required).

ip6_tracertA

Traceroute to an IPv6 host (read-only)

Inputs: host (required).

ip_addrC

Set LAN IP (write — requires confirmation)

Inputs: ip (required), lan (required), user_code, acknowledge, +2 more.

ip_arp_statusA

ARP table (read-only)

Inputs: no named parameters.

ip_bindmacC

Bind IP to MAC address (write — requires confirmation)

Inputs: ip (required), mac (required), user_code, confirm_token, +1 more.

ip_dnsforwardC

DNS forward table (read-only)

Inputs: no named parameters.

ipf_ruleD

Manage IP filter rules (write — requires confirmation)

Inputs: param (required), user_code, acknowledge, confirm_token, +1 more.

ipf_setC

Set IP filter option (write — requires confirmation)

Inputs: param (required), user_code, acknowledge, confirm_token, +1 more.

ipf_viewB

IP filter rules view (read-only)

Inputs: no named parameters.

ip_lanDNSResB

LAN DNS resolution cache (read-only)

Inputs: no named parameters.

ip_nmaskA

Set LAN netmask (write — requires confirmation)

Inputs: lan (required), mask (required), user_code, acknowledge, +2 more.

ip_pingA

Ping an IPv4 host (5 packets) (read-only)

Inputs: host (required).

ip_route_addB

Add a static route (write — requires confirmation)

Inputs: gw (required), dest (required), mask (required), user_code, +2 more.

ip_route_delA

Delete a static route (write — requires confirmation)

Inputs: dest (required), mask (required), user_code, confirm_token, +1 more.

ip_route_statusA

Routing table (connected/static/default) (read-only)

Inputs: no named parameters.

ip_sessionA

IP session table (read-only)

Inputs: no named parameters.

ip_tracertA

Traceroute to an IPv4 host (read-only)

Inputs: host (required).

ldap_setC

Configure LDAP (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

ldap_userC

LDAP user operations (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

ldap_viewA

LDAP configuration view (read-only)

Inputs: no named parameters.

linux_setlinuxipC

Set Linux app IP (first time; reboot to apply) (write — requires confirmation)

Inputs: ip (required), cidr (required), gateway (required), user_code, +3 more.

linux_ssh_disableC

Disable SSH service to the Linux environment (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

linux_ssh_enableC

Enable SSH service to the Linux environment (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

linux_ssh_portC

Set SSH port for the Linux environment (write — requires confirmation)

Inputs: port (required), user_code, confirm_token, confirmation_id.

linux_statusC

Linux application status (read-only)

Inputs: no named parameters.

local8021x_showB

Local 802.1X configuration (read-only)

Inputs: no named parameters.

local8021x_show_local_cerB

Local 802.1X certificates (read-only)

Inputs: no named parameters.

log_callA

Call log (read-only)

Inputs: no named parameters.

log_filterC

IP filter log (read-only)

Inputs: no named parameters.

log_pppB

PPP/MP log (read-only)

Inputs: no named parameters.

log_tailB

Display logs to the end (read-only)

Inputs: no named parameters.

log_wanC

WAN log (read-only)

Inputs: no named parameters.

mngt_bfpC

Enable/disable brute-force protection (write — requires confirmation)

Inputs: onoff (required), user_code, acknowledge, confirm_token, +1 more.

mngt_defensewormB

Enable/disable worm defense (write — requires confirmation)

Inputs: onoff (required), user_code, confirm_token, confirmation_id.

mngt_httpportC

Set HTTP port (write — requires confirmation)

Inputs: port (required), user_code, acknowledge, confirm_token, +1 more.

mngt_httpsportC

Set HTTPS port (write — requires confirmation)

Inputs: port (required), user_code, acknowledge, confirm_token, +1 more.

mngt_nopingB

Enable/disable ping response (write — requires confirmation)

Inputs: onoff (required), user_code, confirm_token, confirmation_id.

mngt_sshportC

Set SSH port (write — requires confirmation)

Inputs: port (required), user_code, acknowledge, confirm_token, +1 more.

mngt_sshtimeoutB

Set SSH session timeout (write — requires confirmation)

Inputs: minutes (required), user_code, confirm_token, confirmation_id.

mngt_telnetportB

Set telnet port (write — requires confirmation)

Inputs: port (required), user_code, acknowledge, confirm_token, +1 more.

mngt_telnettimeoutC

Set telnet session timeout (write — requires confirmation)

Inputs: minutes (required), user_code, confirm_token, confirmation_id.

msubnet_statusB

Multi-subnet status (read-only)

Inputs: no named parameters.

msubnet_switchA

Enable/disable multi-subnet (write — requires confirmation)

Inputs: onoff (required), user_code, acknowledge, confirm_token, +1 more.

nand_badB

NAND bad blocks (read-only)

Inputs: no named parameters.

nand_usageB

NAND storage usage (read-only)

Inputs: no named parameters.

nat_dmzC

Set DMZ host (write — requires confirmation)

Inputs: lan (required), host (required), user_code, acknowledge, +2 more.

nat_viewA

NAT configuration view (read-only)

Inputs: no named parameters.

object_ip_viewC

IP objects view (read-only)

Inputs: no named parameters.

object_service_viewC

Service objects view (read-only)

Inputs: no named parameters.

portmaptime_flushC

Flush all portmaps (diagnostics) (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

portmaptime_listA

List port mapping timeout settings (read-only)

Inputs: no named parameters.

portmaptime_setC

Set port mapping session timeout (t=TCP, u=UDP, i=ICMP, w=WWW, s=SYN) (write — requires confirmation)

Inputs: proto (required), seconds (required), user_code, confirm_token, +1 more.

port_sniff_statusC

Port sniffing status (read-only)

Inputs: no named parameters.

port_speedC

Set ethernet port speed/duplex (write — requires confirmation)

Inputs: port (required), speed (required), user_code, confirm_token, +1 more.

port_statusB

Ethernet port status (read-only)

Inputs: no named parameters.

qos_classC

Configure QoS class (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

qos_setupC

Configure QoS (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

radius_showB

RADIUS configuration (read-only)

Inputs: no named parameters.

radius_show_local_cerB

RADIUS local certificates (read-only)

Inputs: no named parameters.

service_getC

MyVigor service data (read-only)

Inputs: no named parameters.

service_showC

MyVigor service status (read-only)

Inputs: no named parameters.

show_clienttrafficB

Per-client traffic statistics (read-only)

Inputs: no named parameters.

show_cocpuB

Co-processor usage (read-only)

Inputs: no named parameters.

show_cpuC

CPU usage (read-only)

Inputs: no named parameters.

show_cputempB

CPU temperature (read-only)

Inputs: no named parameters.

show_dmzA

DMZ host configuration (read-only)

Inputs: no named parameters.

show_dnsB

DNS server settings per LAN (read-only)

Inputs: no named parameters.

show_flowC

Flow tracking view (read-only)

Inputs: no named parameters.

show_lanA

LAN/VLAN interfaces: IP, mask, DHCP pool, gateway (read-only)

Inputs: no named parameters.

show_memoryA

Memory usage (read-only)

Inputs: no named parameters.

show_natA

NAT port redirection running table (read-only)

Inputs: no named parameters.

show_openportB

Opened ports (NAT) (read-only)

Inputs: no named parameters.

show_pmtimeC

Port mapping timeout settings (read-only)

Inputs: no named parameters.

show_portmapC

Port mapping table (read-only)

Inputs: no named parameters.

show_qryrdslA

Query ADSL/VDSL line info (read-only)

Inputs: no named parameters.

show_sessionB

Session usage statistics (read-only)

Inputs: no named parameters.

show_statisticB

Interface statistics (read-only)

Inputs: no named parameters.

show_statusA

System uptime, LAN DNS, IP, per-WAN link status (read-only)

Inputs: no named parameters.

show_trafficC

Traffic statistics (read-only)

Inputs: no named parameters.

show_voipC

VoIP status (read-only)

Inputs: no named parameters.

switch_listC

Switch port list (read-only)

Inputs: no named parameters.

switch_offC

Disable switch feature (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

switch_onB

Enable switch feature (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

switch_queryC

Switch query (read-only)

Inputs: no named parameters.

switch_statusC

Switch status (read-only)

Inputs: no named parameters.

swm_alertC

Switch alert configuration (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

swm_dbC

Switch database operation (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

swm_detailD

Switch detail operation (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

swm_disableC

Disable switch management (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

swm_enableC

Enable switch management (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

swm_getB

Switch management data (read-only)

Inputs: no named parameters.

swm_groupC

Configure switch group (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

swm_logD

Switch log (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

swm_maintainD

Switch maintenance (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

swm_postC

Switch management POST (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

swm_profileC

Configure switch profile (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

swm_showC

Switch management status (read-only)

Inputs: no named parameters.

swm_snmpD

Switch SNMP (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

swm_tr069C

Switch TR-069 (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

sys_algB

Enable/disable ALG (write — requires confirmation)

Inputs: onoff (required), user_code, confirm_token, confirmation_id.

sys_app_bandwidthA

Application bandwidth usage (read-only)

Inputs: no named parameters.

sys_app_statisticC

Application statistics (read-only)

Inputs: no named parameters.

sys_autorebootC

Configure scheduled auto-restart (mode=hours requires hours param) (write — requires confirmation)

Inputs: mode (required), hours, user_code, confirm_token, +1 more.

sys_ccB

Country / wireless region code (read-only)

Inputs: no named parameters.

sys_cmdlogA

Command history (read-only)

Inputs: no named parameters.

sys_commitB

Save running settings (SRAM) to FLASH (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

sys_dashboardA

Dashboard summary (read-only)

Inputs: no named parameters.

sys_dnsCacheTblA

DNS cache table (read-only)

Inputs: no named parameters.

sys_domainnameB

Set router domain name (write — requires confirmation)

Inputs: domain (required), user_code, confirm_token, confirmation_id.

sys_fr_logB

Failure-related log (read-only)

Inputs: no named parameters.

sys_healthC

System health (read-only)

Inputs: no named parameters.

sys_infoC

System information (read-only)

Inputs: no named parameters.

sys_licenseD

License operations (write — requires confirmation)

Inputs: action (required), user_code, confirm_token, confirmation_id.

sys_mailalertC

Enable/disable mail alert (write — requires confirmation)

Inputs: onoff (required), user_code, confirm_token, confirmation_id.

sys_max_sessionB

Maximum session configuration (read-only)

Inputs: no named parameters.

sys_nameA

Set router name (write — requires confirmation)

Inputs: name (required), user_code, confirm_token, confirmation_id.

sys_passwdC

Change the admin password (write — requires confirmation)

Inputs: new (required), old (required), user_code, acknowledge, +2 more.

sys_pollbufB

Poll buffer usage (read-only)

Inputs: no named parameters.

sys_qrybufC

Memory / buffer usage (read-only)

Inputs: no named parameters.

sys_rebootB

Restart the router immediately (write — requires confirmation)

Inputs: user_code, acknowledge, confirm_token, confirmation_id.

sys_syslogC

Enable/disable syslog (write — requires confirmation)

Inputs: onoff (required), user_code, confirm_token, confirmation_id.

sys_tftpdC

Enable/disable TFTP server for firmware upgrade (write — requires confirmation)

Inputs: onoff (required), user_code, acknowledge, confirm_token, +1 more.

sys_timeB

System time (read-only)

Inputs: no named parameters.

sys_tr069B

Enable/disable TR-069 (write — requires confirmation)

Inputs: onoff (required), user_code, confirm_token, confirmation_id.

sys_versionA

Router model, firmware version, IP, build date (read-only)

Inputs: no named parameters.

sys_webhookB

Enable/disable webhook (write — requires confirmation)

Inputs: onoff (required), user_code, confirm_token, confirmation_id.

tacacsplus_setB

Configure TACACS+ (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

tacacsplus_viewA

TACACS+ configuration view (read-only)

Inputs: no named parameters.

testmail_sendC

Send a test mail (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

upnp_natB

UPnP NAT view (read-only)

Inputs: no named parameters.

upnp_offC

Disable UPnP (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

upnp_onC

Enable UPnP (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

usb_devstatB

USB device status (read-only)

Inputs: no named parameters.

usb_diskC

USB disk info (read-only)

Inputs: no named parameters.

usb_tempC

USB temperature (read-only)

Inputs: no named parameters.

user_accountD

Configure user account (write — requires confirmation)

Inputs: param (required), user_code, acknowledge, confirm_token, +1 more.

user_editC

Edit user profile (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

user_setD

Set user management general setup (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

user_setdefaultB

Reset all user profiles to factory default (write — requires confirmation)

Inputs: user_code, acknowledge, confirm_token, confirmation_id.

vigbrg_setC

Configure Vigor bridge (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

vigbrg_statusB

Vigor bridge status (read-only)

Inputs: no named parameters.

vigbrg_wanstatusA

Vigor bridge WAN status (read-only)

Inputs: no named parameters.

vigbrg_wlanstatusB

Vigor bridge wireless status (read-only)

Inputs: no named parameters.

vlan_groupC

Configure VLAN group (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

vlan_offB

Disable VLAN (write — requires confirmation)

Inputs: user_code, acknowledge, confirm_token, confirmation_id.

vlan_onC

Enable VLAN (write — requires confirmation)

Inputs: user_code, acknowledge, confirm_token, confirmation_id.

vlan_statusB

VLAN status (read-only)

Inputs: no named parameters.

vpn_dial_outC

VPN dial-out configuration (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

vpn_graphC

VPN graph status (read-only)

Inputs: no named parameters.

vpn_listB

VPN profile list (read-only)

Inputs: no named parameters.

vpn_ovpnC

OpenVPN configuration (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

vpn_remoteC

Remote VPN users (read-only)

Inputs: no named parameters.

vpn_setupC

Configure a VPN profile (write — requires confirmation)

Inputs: index (required), param (required), user_code, confirm_token, +1 more.

vrrp_applyC

Apply VRRP configuration (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

vrrp_enableA

Enable/disable VRRP (write — requires confirmation)

Inputs: onoff (required), user_code, acknowledge, confirm_token, +1 more.

vrrp_resetC

Reset VRRP (write — requires confirmation)

Inputs: user_code, confirm_token, confirmation_id.

vrrp_setC

Configure VRRP (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

vrrp_showA

VRRP configuration (read-only)

Inputs: no named parameters.

wan_budgetB

Configure WAN data budget (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

wan_detectA

WAN connection detection status (read-only)

Inputs: no named parameters.

wan_detect_mtuA

WAN MTU detection status (read-only)

Inputs: no named parameters.

wan_detect_mtu6B

IPv6 WAN MTU detection status (read-only)

Inputs: no named parameters.

wan_disableB

Disable a WAN interface (write — requires confirmation)

Inputs: wan (required), user_code, acknowledge, confirm_token, +1 more.

wan_dnsB

Set WAN DNS servers (write — requires confirmation)

Inputs: wan (required), primary (required), secondary, user_code, +2 more.

wan_enableC

Enable a WAN interface (write — requires confirmation)

Inputs: wan (required), user_code, acknowledge, confirm_token, +1 more.

wan_failoverC

Configure WAN failover (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

wan_forwardC

Enable/disable inter-WAN forwarding (write — requires confirmation)

Inputs: onoff (required), user_code, confirm_token, confirmation_id.

wan_lbC

Configure WAN load balancing (write — requires confirmation)

Inputs: param (required), user_code, confirm_token, confirmation_id.

wan_mtuB

Set WAN MTU (write — requires confirmation)

Inputs: mtu (required), wan (required), user_code, confirm_token, +1 more.

wan_statusA

Per-WAN link state, mode, IP, gateway, traffic, DNS (read-only)

Inputs: no named parameters.

wan_vlanB

Set WAN VLAN tag (write — requires confirmation)

Inputs: vid (required), wan (required), user_code, confirm_token, +1 more.

wol_sendA

Send Wake-on-LAN magic packet (write — requires confirmation)

Inputs: mac (required), user_code, confirm_token, confirmation_id.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.4/5.0

    Scored across 217 tools

    Disambiguation2/5

    Many tools have overlapping purposes, such as show_traffic, show_clienttraffic, show_statistic, sys_app_statistic, and sys_app_bandwidth all providing traffic/statistics views. Similarly, multiple status/info tools (show_status, sys_info, sys_health, sys_dashboard) blur boundaries, and several switch management tools (swm_show, swm_get, swm_query-like) are hard to distinguish.

    Naming Consistency3/5

    The naming is mostly verb_noun with prefixes like show_, sys_, wan_, dhcp_, but there is inconsistency: some use show_ (show_traffic), some use status (dhcp_status, linux_status, port_sniff_status), some use view (dos_view, internet_view, nat_view), and some use mixed forms like sys_dnsCacheTbl, sys_fr_log, and portmaptime_list. The pattern is readable but not uniform.

    Tool Count1/5

    217 tools is an extreme number for an MCP server, far beyond the typical well-scoped range. Even for a comprehensive router management interface, this creates overwhelming selection complexity and suggests the server exposes nearly every CLI command as a separate tool rather than a curated API.

    Completeness4/5

    The tool surface is extremely comprehensive, covering nearly every router subsystem: WAN, LAN, DHCP, NAT, VPN, QoS, firewall, VLAN, switch, AP management, IPv6, logging, and more. There are minor gaps (e.g., no explicit firmware upgrade tool beyond TFTP enable, no direct NAT rule creation tool), but the breadth is impressive and most workflows are covered.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to monitor and securely manage AsusWRT and AsusWRT-Merlin routers via SSH with allowlisted commands, supporting read-only monitoring and controlled mutations.
      47
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI clients to perform controlled diagnostics and configuration of Keenetic and Netcraze routers over LAN RCI or remote KeenDNS HTTPS, with read-only mode, guarded writes, and centralized secret masking.
      19
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to audit, inspect, and safely configure MikroTik RouterOS v7 routers through tools for connection testing, system status, security audits, firewall mangle management, routing, DHCP leases, sanitized exports, containers, and adlist queries.
      239 npm
      GPL 3.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to connect to and manage Cisco IOS, Huawei VRP, and H3C Comware switches in natural language over Telnet, SSH, or serial console, with automatic vendor detection, pagination handling, and output sanitization. A companion real-time web console streams every command and device response live, and an optional hardened entry point adds read-only whitelists, approval codes, host allowlists, secret masking, and JSONL audit logging.
      1
      MIT