vigor3912s-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@vigor3912s-mcp show me the current WAN status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
jooservices/vigor3912s-mcp
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
Command registry · Logging schema · Configuration · MCP integration
Vigor 3912S reference (self-contained, incl. original PDFs)
Safety model
SSH host-key pin — set
VIGOR_SSH_HOST_FINGERPRINT(required). UseVIGOR_SSH_INSECURE_SKIP_VERIFY=trueonly for tests / simulated DrayOS.Read tools — unit tests (mocked transport) and local real-router E2E (
npm run e2ewithEXPOSE_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 verifiesVIGOR_APPROVE_PUBKEY.Dangerous writes — additionally require
acknowledge: trueand return a lockout warning (policy insrc/commands/tool-policy.ts).Auto-commit — after a successful confirmed write,
sys commitruns (VIGOR_AUTO_COMMIT; skipped forskipCommit). Outcome inwrite_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 viaVIGOR_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 |
| CLI catalog by family ( |
| Shared Zod arg schemas |
| Confirm tiers / secret fields / sensitive output / snapshots |
| Sign-gated confirm → snapshot → execute → commit → audit |
| MCP tool registration |
| Registry-derived allowlist for |
| SDK client + |
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_pingtarget).Write tools (446) — first call returns a redacted preview +
confirmation_id/sign_payload; second call requiressignature(andacknowledge: truefor 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) |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Requirements
Component | Requirement |
Node.js | >= 24.21.0 and < 25 ( |
npm | >= 12.0.2 and < 13 (SDK package engine) |
| >= 1.3.0; CI defaults to v1.3.0 |
| >= 2.0.0; CI defaults to v2.0.0 |
Install layout | Sibling packages at |
Router | Vigor 3912S with SSH enabled and reachable on the LAN |
Credentials | Admin password and pinned SSH host fingerprint in |
Write approvals | Ed25519 approve public key; not required when |
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 buildRegister 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 excerptwrite_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=trueagainst a live router on an untrusted LAN.
Available Tools
217 toolsapm_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_searchD
Switch search (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
Scored across 217 tools
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.
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.
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.
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
Related MCP Connectors
- DNS-DATA RemoteDeprecatedcom.dns-data
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
Let AI operate servers without SSH. Choose actions, approve risky changes, and audit every step.
BYOK AI router & FinOps control plane: audit token waste, check tool safety, and rank models.
Connect AI assistants to explicitly paired computers, servers, and VMs for permitted remote actions.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to monitor and securely manage AsusWRT and AsusWRT-Merlin routers via SSH with allowlisted commands, supporting read-only monitoring and controlled mutations.473MIT
- AlicenseAqualityBmaintenanceEnables 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.19MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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 npmGPL 3.0
- AlicenseNot gradedqualityCmaintenanceEnables 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.1MIT