Skip to main content
Glama
universal-tplink-mcp

universal-tplink-mcp

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 --> I

Project 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.md

Installation

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 status

Node.js (npm / npx)

# Install globally:
npm install -g tplink-router-suite

# Or run directly on-demand:
npx tplink-router-suite tplink-cli status

Homebrew (macOS & Linux)

brew tap dulithdivisekara/tap
brew install tplink-cli

Debian / 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.deb

Docker 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:latest

Zero-Dependency POSIX Installer

curl -fsSL https://tp-link-cli.dulith.me/install.sh | bash

CLI 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 engine

Subcommands 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 shell

Host-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 start

MCP 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

router_profile_check

Read

Diagnostics

Safe

router_get_status

Read

Diagnostics

Safe

router_get_rf_signal

Read

Cellular

Safe

router_set_cell_lock

Write

Cellular

Requires confirm=True

router_set_lte_band

Write

Cellular

Requires confirm=True

router_get_data_limit

Read

Cellular

Safe

router_get_connected_clients

Read

Diagnostics

Safe

router_manage_dhcp_reservation

Write

Network

Requires confirm=True

router_get_wifi_networks

Read

Wi-Fi

Safe

router_set_wifi_radio

Write

Wi-Fi

Requires confirm=True

router_run_diagnostic

Exec

Diagnostics

Safe

router_run_ussd

Exec

Cellular

Safe

router_read_sms

Read

SMS

Safe

router_send_sms

Write

SMS

Safe

router_reboot

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 web

Session Logging & Inspection

Every command outputs audit records without leaking plaintext credentials:

  • Session Log: ~/.config/tplink-router/session.log

  • MCP Log: ~/.config/tplink-router/mcp.log

  • Config Storage: ~/.config/tplink-router/config.json (POSIX 0600 permissions)

  • 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 tests
Ran 90 tests in 22.172s

OK

Security & Governance

  • Security Policy: Vulnerability disclosure procedures and SafeSession atomic 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 tools
router_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

    B3.4/5.0

    Scored across 39 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      16
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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