universal-tplink-mcp
This MCP server lets an AI assistant monitor and configure TP-Link 4G/LTE and broadband routers through 39 typed tools with safety confirmations and network guards.
Inspect router status, LTE/RF signal metrics, WAN, Wi-Fi, clients, data usage, LEDs, logs, time, operation mode, DDNS, firmware, and diagnostics.
Lock/unlock cell towers, set LTE bands, calibrate RF bands, run USSD queries, read/send SMS, and manage data limits.
Configure DNS, IPv6, Wi-Fi radios, guest Wi-Fi, DHCP reservations, port forwarding, DMZ, UPnP, LED night mode, and reboot schedules.
Run diagnostics, sync time, clear logs, reboot the router, and perform profile/network safety checks before changes.
Provides tools for administering TP-Link routers, including device and WAN status, LTE signal metrics, cell/band locking, connected clients, DHCP reservations, Wi-Fi control, LED schedules, DNS/IPv6 settings, diagnostics, reboots, SMS, and USSD commands.
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., "@universal-tplink-mcp check my router's LTE signal and list connected devices"
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.
Overview
TP-Link Router Suite is a single, production-grade monorepo unifying reverse-engineered protocol implementations (TR-064 / AES-128 / RSA-1024), human-facing command-line tools, and agentic Model Context Protocol (MCP 2.x) servers across TP-Link 4G/LTE gateways and broadband routers.
Conceived in Malabe, Sri Lanka near the SLIIT Campus, this system was developed to solve acute cellular routing drops, tower flapping, and bufferbloat on Hutch 4G LTE unlimited packages using TP-Link Archer MR200 gateways. To operate safely across university infrastructure, mobile hotspots, and private residential networks, the suite features a zero-trust multi-environment network guard that audits default gateways and SSIDs prior to dispatching mutations.
Key capabilities include atomic single-admin session leasing (SafeSession), live 3GPP cellular telemetry extraction (RSRP, RSRQ, SNR, EARFCN, PCI), automated cell tower locking, carrier band selection, host-side TCP BBR optimization, and an interactive Terminal UI built with React 19 and Ink.
Related MCP server: ax11000-mcp
Architecture & Modes
The monorepo organizes communication with TP-Link hardware into four discrete operational interfaces, ensuring non-overlapping session lifecycles and thread-safe lock management.
Operational Interface | Runtime Engine | Terminal Rendering | Session Model | Primary Deliverable |
Ink React TUI | Node.js 18+ / React 19 | Full-screen Yoga v3 Flexbox | Live Async Event Loop | Interactive monitoring dashboard |
Python TUI Fallback | Pure Python 3.10+ / Rich | Standard ANSI buffer | Sequential polling | Environments without Node.js |
Subcommand CLI | Native Binary / Script | Plain text stdout / JSON | Atomic single-command lease | Automation scripts and cron jobs |
MCP 2.x Server | Python stdio / JSON-RPC | Headless RPC stream | Atomic SafeSession leasing | AI assistants (Antigravity, Claude, Cursor) |
graph TD
A[TP-Link Gateway 192.168.1.1] --> B[Core Engine tplink_router]
B --> C[NetworkGuard Pre-Flight Check]
C --> D[SafeSession Atomic Lease Manager]
D --> E[CLI Suite: tplink-cli & React Ink TUI]
D --> F[MCP 2.x Server: 39 Typed Tools]
E --> G[Web Portal: CLI Terminal Emulator web/cli/]
F --> H[Web Portal: MCP Schema Explorer web/mcp/]
G --> I[Unified Developer Showcase web/index.html]
H --> IProject Structure
.
├── tplink_router/ # Core Python package (CLI, MCP, and protocol adapters)
│ ├── core/ # Session leasing, crypto handshakes, network safety
│ ├── clients/ # Hardware-specific adapters (MR LTE vs Broadband)
│ ├── cli/ # 31 CLI subcommands, theme engines, and REPL
│ ├── mcp/ # MCP 2.x server exposing 39 typed tools
│ ├── calibration/ # Autonomous RF band sweep and calibration engine
│ └── models/ # Typed telemetry and configuration models
├── bin/ # Cross-platform Node.js launchers for npm/npx
│ ├── tplink-cli.js # CLI dispatcher
│ └── tplink-mcp.js # MCP stdio launcher
├── distribution/ # Multi-ecosystem packaging specifications
│ ├── Dockerfile # Container definition for GHCR deployment
│ ├── smithery.yaml # Smithery MCP registry manifest
│ ├── Formula/tplink-cli.rb # Homebrew package tap formula
│ ├── debian/control # Debian APT package definition
│ └── install.sh # POSIX zero-dependency installation script
├── ink-src/ # React 19 + Ink animated Terminal UI
├── docs/ # Reverse-engineered endpoint catalog (95 endpoints)
├── scripts/ # Network optimization, keepalive, and schema extractors
│ ├── optimize-network.sh # TCP BBR, FQ, and MTU 1420 GTP clamping
│ ├── keepalive-pulse.sh # 28-byte background cellular keepalive heartbeat
│ └── extract-catalog.py # Automated schema sync into web portals
├── tests/ # Unified automated test suite (90 unit tests)
├── web/ # Unified Web Showcase & Documentation Portal
│ ├── index.html # Unified Developer Portal
│ ├── cli/ # Interactive CLI Terminal Simulator (33 subcommands)
│ ├── mcp/ # MCP Schema Explorer & AI Config Generator (39 tools)
│ └── scripts/build.py # Static generator and schema validator
├── CONTRIBUTING.md # Developer workflow and pull request guidelines
├── SECURITY.md # Security policy and session leasing invariants
├── CODE_OF_CONDUCT.md # Contributor Covenant v2.1
├── CHANGELOG.md # Release history and migration guide
├── LICENSE # MIT License
├── package.json # npm root manifest
├── pyproject.toml # Python build configuration
└── README.mdInstallation
Select your preferred runtime or package manager:
Python PyPI (pip / pipx)
# Install CLI and MCP server globally:
pip install tplink-router-suite
# Or run isolated:
pipx run tplink-router-suite tplink-cli statusNode.js (npm / npx)
# Install globally:
npm install -g tplink-router-suite
# Or run directly on-demand:
npx tplink-router-suite tplink-cli statusHomebrew (macOS & Linux)
brew tap dulithdivisekara/tap
brew install tplink-cliDebian / Ubuntu (APT Package)
curl -fsSLO https://tp-link-cli.dulith.me/tplink-cli_1.0.0_all.deb
sudo dpkg -i tplink-cli_1.0.0_all.debDocker Container (Zero-Install MCP)
docker run -i --rm --network host \
-e TPLINK_ROUTER_IP="http://192.168.1.1" \
-e TPLINK_PASSWORD="your_router_password" \
ghcr.io/dulithdivisekara/tplink-mcp:latestZero-Dependency POSIX Installer
curl -fsSL https://tp-link-cli.dulith.me/install.sh | bashCLI Suite Guide
Interactive React Ink Terminal User Interface
tplink-cli # Launch animated full-screen React Ink TUI (default in TTY)
tplink-cli --mono # High-contrast Monochrome mode
tplink-cli --no-anim # Disable transient animations and shimmer
tplink-cli --python-tui # Use pure-Python fallback TUI engineSubcommands Overview
# Telemetry & Radio
tplink-cli status # Gateway, cellular, and WAN telemetry
tplink-cli status --json # Structured JSON output for scripts
tplink-cli signal # Live 3GPP RSRP, RSRQ, SNR metrics
tplink-cli profile check # Verify active Wi-Fi SSID and Gateway safety
# Cellular & Band Control
tplink-cli cell-lock # Query base station lock status
tplink-cli cell-lock --enable --earfcn 1550 --pci 58 # Lock modem to specific tower
tplink-cli band 3 # Pin modem to LTE Band 3 (1800 MHz)
tplink-cli band auto # Restore dynamic carrier aggregation
tplink-cli data-limit # Show monthly cellular quota & live bandwidth
# Connected Devices & LAN
tplink-cli clients # List connected LAN devices (IP, MAC, Hostname)
tplink-cli reservation list # Enumerate static DHCP reservations
tplink-cli reservation add AA:BB:CC:DD:EE:FF 192.168.1.50 # Add static IP binding
# Hardware & System
tplink-cli wifi # Query 2.4 GHz and 5 GHz wireless status
tplink-cli leds --night-mode on --start 23:00 --end 07:00 # Auto-disable front panel LEDs
tplink-cli diag # Run WAN reachability and link self-tests
tplink-cli reboot # Graceful router hardware restart
tplink-cli repl # Launch authenticated interactive shellHost-Side Cellular Performance Optimizer
# Apply TCP BBR congestion control, FQ queueing, and MTU 1420 GTP clamping
sudo ./scripts/optimize-network.sh enable
# Start 28-byte background keepalive heartbeat to avoid cellular dormancy
./scripts/keepalive-pulse.sh startMCP Server Guide
Connect TP-Link hardware directly to autonomous AI copilots with 39 typed tools.
Claude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"tplink-router": {
"command": "npx",
"args": ["-y", "tplink-router-suite", "tplink-mcp"],
"env": {
"TPLINK_ROUTER_IP": "http://192.168.1.1",
"TPLINK_PASSWORD": "your_router_password"
}
}
}
}Google Antigravity & Cursor Configuration
Configure directly via Python stdio transport:
{
"mcpServers": {
"tplink-router": {
"command": "python3",
"args": ["-m", "tplink_router.mcp.server"],
"env": {
"TPLINK_ROUTER_IP": "http://192.168.1.1",
"TPLINK_PASSWORD": "your_router_password"
}
}
}
}Selected MCP Tools Catalog
Tool Name | Operation | Category | Safety Guard |
| Read | Diagnostics | Safe |
| Read | Diagnostics | Safe |
| Read | Cellular | Safe |
| Write | Cellular | Requires confirm=True |
| Write | Cellular | Requires confirm=True |
| Read | Cellular | Safe |
| Read | Diagnostics | Safe |
| Write | Network | Requires confirm=True |
| Read | Wi-Fi | Safe |
| Write | Wi-Fi | Requires confirm=True |
| Exec | Diagnostics | Safe |
| Exec | Cellular | Safe |
| Read | SMS | Safe |
| Write | SMS | Safe |
| Exec | System | Requires confirm=True |
Web Showcase & Portal
The web/ directory houses the documentation showcase and interactive simulators:
Unified Portal (
web/index.html): Developer hub connecting CLI and MCP portals.CLI Terminal Simulator (
web/cli/): Browser-based emulator demonstrating 33 subcommands and live benchmarks.MCP Schema Explorer (
web/mcp/): Mintlify-styled tool catalog with interactive modal schema inspection.
# Validate schemas and build pre-rendered HTML
python3 web/scripts/build.py
# Start local preview server
python3 -m http.server 8080 --directory webSession Logging & Inspection
Every command outputs audit records without leaking plaintext credentials:
Session Log:
~/.config/tplink-router/session.logMCP Log:
~/.config/tplink-router/mcp.logConfig Storage:
~/.config/tplink-router/config.json(POSIX0600permissions)Live Stream:
tail -f ~/.config/tplink-router/session.log
Verification Tests
Execute the automated test suite verifying session leasing, multi-environment guards, TR-064 response parsing, and RF band calibration:
python3 -m unittest discover testsRan 90 tests in 22.172s
OKSecurity & Governance
Security Policy: Vulnerability disclosure procedures and
SafeSessionatomic concurrency invariants.Contributing Guide: Environment setup, PR guidelines, and coding standards.
Code of Conduct: Contributor Covenant v2.1 standards.
Changelog: Historical version releases and monorepo migration notes.
License
This project is licensed under the MIT License.
Available Tools
39 toolsrouter_add_port_forwardingA
Creates a new NAT virtual server port forwarding rule on the router.
Args: name: Service or descriptive name (e.g. 'web', 'ssh', 'minecraft'). external_port: Incoming WAN port or port range (e.g. '8080' or '8000-8010'). internal_ip: LAN destination IP address (e.g. '192.168.1.150'). internal_port: LAN destination port (defaults to external_port if omitted). protocol: Transport protocol ('TCP', 'UDP', or 'ALL'). confirm: Confirmation flag to add rule. force: Set to True to bypass Network Guard safety check.
Inputs: name (required), internal_ip (required), external_port (required), force, +3 more. Returns: result
router_calibrateA
Runs autonomous RF band calibration across LTE frequencies (Band 8, 3, 1, 40, Auto) with 45s watchdog fail-safe.
Launches a real-time Live Web Dashboard on http://localhost:8765. During band switches, the router modem temporarily detaches for 5-15 seconds. The local daemon safeguards against permanent disconnection by auto-reverting if WAN drops for >45s.
Args: web: Launch real-time Web UI on localhost:8765 (default: True). port: Web dashboard port (default: 8765). dry_run: Simulate band switches without modem detachment. confirm: Confirmation flag to execute calibration.
Inputs: web, port, confirm, dry_run. Returns: result
router_check_firmwareB
Checks for available online official TP-Link firmware updates.
Args: force: Set to True to bypass Network Guard safety check.
Inputs: force. Returns: result
router_clear_system_logsA
Clears the internal system event log buffer on the router.
Args: confirm: Safety confirmation. Set to True to clear logs. force: Set to True to bypass Network Guard safety check.
Inputs: force, confirm. Returns: result
router_del_port_forwardingC
Deletes an existing NAT virtual server port forwarding rule by stack ID.
Args: rule_stack: Stack identifier of the rule to remove (e.g. '2,1,1,1,0,0'). confirm: Confirmation flag to delete rule. force: Set to True to bypass Network Guard safety check.
Inputs: rule_stack (required), force, confirm. Returns: result
router_get_connected_clientsB
Retrieves all connected wired and wireless devices currently on the router LAN.
Returns hostnames, IP addresses, MAC addresses, and lease durations.
Inputs: force. Returns: result
router_get_data_limitB
Retrieves monthly cellular data allowance, billing cycle start day, and live bandwidth.
Inputs: force. Returns: result
router_get_ddnsA
Retrieves Dynamic DNS (DDNS) provider configurations (TP-Link Cloud, No-IP, DynDNS).
Args: force: Set to True to bypass Network Guard safety check.
Inputs: force. Returns: result
router_get_dmzB
Retrieves DMZ (Demilitarized Zone) host forwarding status and destination IP.
Args: force: Set to True to bypass Network Guard safety check.
Inputs: force. Returns: result
router_get_guest_wifiA
Retrieves current dual-band (2.4GHz / 5GHz) Guest Wi-Fi status, SSIDs, and isolation settings.
Args: force: Set to True to bypass Network Guard safety check.
Inputs: force. Returns: result
router_get_led_statusB
Retrieves the physical LED status and night mode schedule.
Inputs: force. Returns: result
router_get_operation_modeB
Retrieves the active router operation mode (3G/4G Router Mode vs Wireless Router Mode).
Args: force: Set to True to bypass Network Guard safety check.
Inputs: force. Returns: result
router_get_port_forwardingA
Lists active NAT Virtual Server port forwarding rules on the cellular WAN interface.
Args: force: Set to True to bypass Network Guard safety check.
Inputs: force. Returns: result
router_get_reboot_scheduleA
Retrieves the automated periodic reboot schedule settings.
Args: force: Set to True to bypass Network Guard safety check.
Inputs: force. Returns: result
router_get_rf_signalB
Retrieves real-time 4G LTE RF signal metrics (RSRP, RSRQ, SNR, EARFCN, PCI, Signal Bars).
Guides router placement and antenna alignment for maximum 4G speed in Sri Lanka (e.g. Malabe/SLIIT).
Inputs: force. Returns: result
router_get_statusA
Retrieves full device, cellular LTE, RF signal metrics, and WAN network status.
Args: force: Set to True to bypass Network Guard SSID/Gateway validation.
Inputs: force. Returns: result
router_get_system_logsA
Retrieves system and cellular event logs from the TP-Link router.
Args: lines: Maximum number of recent log entries to return (default: 50). module: Optional filter by subsystem (e.g. '4G', 'DHCP', 'System', 'DNS'). min_level: Optional minimum severity filter ('EMERG', 'ALERT', 'CRIT', 'ERROR', 'WARN', 'NOTICE', 'INFO', 'DEBUG'). force: Set to True to bypass Network Guard safety check.
Inputs: force, lines, module, min_level. Returns: result
router_get_timeB
Retrieves current router system clock, time zone, daylight savings, and NTP server status.
Args: force: Set to True to bypass Network Guard safety check.
Inputs: force. Returns: result
router_get_upnpB
Retrieves Universal Plug and Play (UPnP) status and active dynamic port mappings.
Args: force: Set to True to bypass Network Guard safety check.
Inputs: force. Returns: result
router_get_wifi_networksC
Retrieves status, SSIDs, channels, and operational state of 2.4 GHz and 5 GHz Wi-Fi radios.
Inputs: force. Returns: result
router_manage_dhcp_reservationA
Manages static DHCP IP address reservations on the router.
Args: action: 'add', 'delete', or 'list'. mac: Hardware MAC address (e.g. 'AA:BB:CC:DD:EE:FF', required for 'add' or 'delete'). ip: Desired reserved IP address (required for 'add'). confirm: Confirmation required for 'add' or 'delete'. force: Set to True to bypass Network Guard safety check.
Inputs: action (required), ip, mac, force, +1 more. Returns: result
router_profile_checkA
Inspects the current host network environment (SSID, Gateway) to ensure connection safety.
Use this tool before applying configuration changes to confirm that the host is connected to the target router and not University Wi-Fi (e.g. SLIIT) or a mobile hotspot.
Inputs: no named parameters. Returns: result
router_read_smsA
Reads incoming or sent SMS messages from the router SIM inbox (e.g. package expiry alerts).
Args: limit: Maximum number of SMS messages to retrieve (default 10). folder: Message folder ('inbox' or 'sent'). force: Set to True to bypass Network Guard safety check.
Inputs: force, limit, folder. Returns: result
router_rebootA
Initiates a graceful reboot of the TP-Link router.
IMPORTANT: Rebooting will terminate the host's internet and Wi-Fi connection for ~60-90 seconds. You MUST provide confirm=True to execute.
Args: confirm: Safety confirmation. Set to True to trigger the restart. force: Set to True to bypass Network Guard safety check.
Inputs: force, confirm. Returns: result
router_run_diagnosticC
Runs a router-side diagnostic self-test verifying physical link, WAN IP, and Internet NCSI reachability.
Inputs: force. Returns: result
router_run_ussdA
Executes a USSD query on the cellular SIM card (e.g. '*344#' for Hutch quota, '*123#' for balance).
Args: code: USSD string to send. force: Set to True to bypass Network Guard safety check.
Inputs: code (required), force. Returns: result
router_send_smsB
Sends an SMS message through the router SIM card.
Args: to_phone: Recipient phone number. message: Message text content. force: Set to True to bypass Network Guard safety check.
Inputs: message (required), to_phone (required), force. Returns: result
router_set_cell_lockA
Locks or unlocks the router to a specific cellular base station tower (EARFCN + PCI).
IMPORTANT: Changing the cell tower momentarily drops and renegotiates the cellular link. You MUST provide confirm=True to execute.
Args: enable: True to lock to cell, False to unlock (return to auto roaming). earfcn: E-UTRA Absolute Radio Frequency Channel Number (e.g. '1550' for Band 3). pci: Physical Cell Identity (e.g. '58'). confirm: Safety confirmation. Set to True to proceed with connection renegotiation. force: Set to True to bypass Network Guard safety check.
Inputs: enable (required), pci, force, earfcn, +1 more. Returns: result
router_set_data_limitA
Configures monthly cellular data quota, billing day reset, and usage alert threshold.
Args: limit_mb: Total monthly data allowance in Megabytes (e.g. 50000 for 50GB). payment_day: Day of month when billing cycle resets (1-31). warning_percent: Threshold percent to trigger alert (e.g. 90). enable: True to enforce quota, False to disable. confirm: Confirmation required to apply data quota limits. force: Set to True to bypass Network Guard safety check.
Inputs: limit_mb (required), force, enable, confirm, +2 more. Returns: result
router_set_dmzB
Enables or disables DMZ host forwarding to an internal IP address.
Args: enabled: True to enable DMZ, False to disable. ip_address: Internal IP address to receive all unmapped incoming traffic. confirm: Confirmation flag to modify DMZ. force: Set to True to bypass Network Guard safety check.
Inputs: enabled (required), force, confirm, ip_address. Returns: result
router_set_dnsA
Configures custom DNS resolvers on the router's WAN connection.
Args: primary_dns: Primary DNS IP (e.g. '8.8.8.8' for Google DNS, '1.1.1.1' for Cloudflare). secondary_dns: Secondary DNS IP (default '8.8.8.8'). force: Set to True to bypass Network Guard safety check.
Inputs: primary_dns (required), force, secondary_dns. Returns: result
router_set_guest_wifiB
Configures or toggles dual-band Guest Wi-Fi networks and local LAN isolation.
Args: band: Target band ('2.4GHz', '5GHz', or 'both'). enabled: Enable (True) or disable (False) Guest Wi-Fi on selected band. ssid: Custom SSID name for the guest network. password: WPA2-PSK password (minimum 8 characters, or empty string '' for open network). allow_lan: If True, guests can reach LAN devices; if False, guests are isolated to Internet-only. confirm: Confirmation flag to apply configuration. force: Set to True to bypass Network Guard safety check.
Inputs: band, ssid, force, confirm, +3 more. Returns: result
router_set_led_night_modeA
Configures night mode to turn off router front panel LEDs automatically during sleeping hours.
Args: enable: True to activate night mode schedule, False to disable. start_time: 'HH:MM' time when LEDs turn OFF (e.g. '22:00'). end_time: 'HH:MM' time when LEDs turn back ON (e.g. '07:00'). force: Set to True to bypass Network Guard safety check.
Inputs: enable (required), force, end_time, start_time. Returns: result
router_set_lte_bandA
Manually locks router to a specific LTE band (e.g. '3' for 1800MHz, '8' for 900MHz, '40' for 2300MHz, or 'auto').
Essential for locking to optimal Hutch/Dialog 4G towers in Sri Lanka (e.g. Malabe). IMPORTANT: Changing bands triggers cellular radio renegotiation.
Args: band: LTE Band number (e.g. '3', '8', '40') or 'auto'. confirm: Safety confirmation. Set to True to execute band change. force: Set to True to bypass Network Guard safety check.
Inputs: band (required), force, confirm. Returns: result
router_set_reboot_scheduleA
Configures or disables automated daily or weekly periodic router reboots.
Args: enabled: True to enable auto-reboot, False to disable. hours: Hour of the day in 24h format (0-23, default: 3). minutes: Minute of the hour (0-59, default: 0). mode: Repeat frequency ('daily' or 'weekly'). day_of_week: Day of week for weekly mode (1=Mon, 2=Tue, ..., 7=Sun). confirm: Confirmation flag to apply schedule. force: Set to True to bypass Network Guard safety check.
Inputs: enabled (required), mode, force, hours, +3 more. Returns: result
router_set_upnpB
Enables or disables UPnP dynamic port forwarding on the router.
Args: enabled: True to enable UPnP, False to disable. confirm: Confirmation flag to modify UPnP. force: Set to True to bypass Network Guard safety check.
Inputs: enabled (required), force, confirm. Returns: result
router_set_wifi_radioA
Enables or disables a Wi-Fi radio (2.4GHz or 5GHz) and optionally updates its SSID.
IMPORTANT: Disabling the Wi-Fi band you are currently connected to will disconnect your host! You MUST provide confirm=True to execute.
Args: band: '2.4GHz' or '5GHz'. enable: True to enable radio, False to disable. ssid: Optional new SSID name. confirm: Safety confirmation. Set to True to apply radio changes. force: Set to True to bypass Network Guard safety check.
Inputs: band (required), enable (required), ssid, force, +1 more. Returns: result
router_sync_timeA
Triggers an immediate NTP network time synchronization on the router.
Args: force: Set to True to bypass Network Guard safety check.
Inputs: force. Returns: result
router_toggle_ipv6A
Enables or disables the IPv6 stack on the router's cellular connection.
Disabling IPv6 is recommended if Hutch IPv6 routing is introducing dual-stack timeout delays.
Args: enable: True to enable IPv6, False to disable. force: Set to True to bypass Network Guard safety check.
Inputs: enable (required), force. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 39 tools
Most tools target a distinct resource+action pair (DNS, DMZ, UPnP, guest Wi-Fi, port forwarding), but the cellular-tuning cluster overlaps: router_set_cell_lock, router_set_lte_band, and router_calibrate all renegotiate the radio to different towers/bands. Similarly router_get_status, router_get_rf_signal, and router_run_diagnostic partially overlap in connectivity reporting, though descriptions do help separate them.
Strong, predictable router_<verb>_<noun> pattern throughout (router_get_*, router_set_*, router_add_*, router_del_*), with a consistent shared arg vocabulary (confirm, force). Minor deviations: router_manage_dhcp_reservation uses a vague 'manage' verb instead of add/delete/list, router_profile_check is noun_verb order, and 'del' is abbreviated where other tools spell things out.
39 tools is heavy for a single router surface and pushes well past the comfortable 3-15 range, with several near-duplicate getters that could be folded into a single status call. Each tool does map to a real router feature, so it is not gratuitous padding, but the surface is on the bloated side.
Coverage is broad and balanced: DHCP reservations, DNS, IPv6, Wi-Fi radios, guest networks, NAT/DMZ/UPnP, SMS/USSD, data quotas, logs, scheduling, and diagnostics are all present with get/set pairs. Gaps remain: firmware is check-only (no update action), and there is no WPS, MAC/access-control filtering, or static routing surface.
Maintenance
Related MCP Connectors
Network, domain and website diagnostics for AI clients via MCP.
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
Email inboxes, webhook URLs, mock APIs and 170+ tools for coding agents over one MCP connection.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI agents to manage TP-Link routers by listing clients, checking status, controlling Wi-Fi, and rebooting via natural language.332MIT
- AlicenseBqualityBmaintenanceEnables Claude Code and other MCP clients to inspect and manage a TP-Link router over stdio, including device lists, DHCP leases and reservations, Wi-Fi settings, firmware and IP status, mesh nodes, and safe raw endpoint requests with confirmation for writes and secret masking.16MIT
- AlicenseNot gradedqualityBmaintenanceEnables LLM/MCP clients to read and, when explicitly allowed, modify TP-Link Archer AX53 router settings directly over the LAN using the router's own web protocol, without a browser or cloud account. It is read-first, write-gated, and lockout-aware, with tools for clients, DHCP, Wi-Fi, access control, presence history, and other router operations.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI copilots and autonomous agents to inspect, diagnose, and safely manage TP-Link 4G/LTE gateways and broadband routers through typed MCP tools for status, signal, clients, Wi-Fi, DNS, SMS/USSD, and guarded mutations. It provides session leasing and confirmation safeguards to avoid locking out admins or disconnecting active sessions.MIT