Iptime-mcp Server

A safety-gated Model Context Protocol (MCP) server for operating ipTIME routers without repeatedly opening the web admin panel.

Local serverstdioMIT

What is the Iptime-mcp Server?

iptime-mcp is an MCP project maintained in the mikusnuz/iptime-mcp repository. The maintainer describes its purpose as “A safety-gated Model Context Protocol (MCP) server for operating ipTIME routers without repeatedly opening the web admin panel”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using node. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares IPTIME_ROUTER_ID, IPTIME_ROUTER_URL, IPTIME_ROUTER_USERNAME, IPTIME_ROUTER_PASSWORD. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
iptime_status	Detect the interface, authenticate when credentials exist, and read product/system status
iptime_login	Log in with credentials from the MCP environment; optionally submit a CAPTCHA answer
iptime_logout	End the current router admin session
iptime_capabilities	Check catalogued operations against the target model and firmware
iptime_list_operations	List the local, auditable operation catalog by domain or mode
iptime_read	Run one read-only catalog operation
iptime_backup_config	Save a new .config backup file without overwriting an existing file
iptime_plan_change	Create a generic router-change plan without applying it
iptime_plan_firmware_upgrade	Hash a local .bin image and create a critical-risk upgrade plan
iptime_plan_config_restore	Hash a local .config backup and create a critical-risk restore plan
iptime_apply_change	Apply one pending plan by ID; no confirmation token required
iptime_cancel_change	Cancel a pending plan
iptime_list_plans	List pending and completed in-memory plans

How to install the Iptime-mcp Server

{
  "mcpServers": {
    "iptime": {
      "command": "node",
      "args": [
        "/absolute/path/to/iptime-mcp/dist/server.js"
      ],
      "env": {
        "IPTIME_ROUTER_ID": "home",
        "IPTIME_ROUTER_URL": "http://192.168.0.1",
        "IPTIME_ROUTER_USERNAME": "admin",
        "IPTIME_ROUTER_PASSWORD": "YOUR_IPTIME_ROUTER_PASSWORD"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
IPTIME_ROUTER_ID	Declared in the maintainer’s client configuration.	Check documentation
IPTIME_ROUTER_URL	Declared in the maintainer’s client configuration.	Check documentation
IPTIME_ROUTER_USERNAME	Declared in the maintainer’s client configuration.	Check documentation
IPTIME_ROUTER_PASSWORD	Declared in the maintainer’s client configuration.	Check documentation