@usex/mikrotik-mcp 3.31.1 → 3.32.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usex/mikrotik-mcp",
-  "version": "3.31.1",
+  "version": "3.32.1",
   "description": "MCP server for MikroTik RouterOS — 660+ tools over SSH for firewall, NAT, routing, DHCP, DNS, WireGuard, wireless, QoS and more.",
   "keywords": [
     "ai",

package/schemas/README.md

@@ -7,7 +7,7 @@ edit by hand — regenerate instead.
 | File                 | Contents                                                                                   |
 | -------------------- | ------------------------------------------------------------------------------------------ |
 | `config.schema.json` | The runtime configuration object (env vars / CLI flags).                                   |
-| `tool-catalog.json`  | Every one of the 758 tools: `name`, `risk`, `title`, `description`, and input JSON Schema. |
+| `tool-catalog.json`  | Every one of the 759 tools: `name`, `risk`, `title`, `description`, and input JSON Schema. |
 | `tools/<name>.json`  | The input JSON Schema for a single tool.                                                   |
 
 `risk` is derived from the MCP tool annotations:

package/schemas/tool-catalog.json

@@ -1,9 +1,31 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "3.29.0",
+  "version": "3.31.1",
   "generated": "by scripts/gen-schemas.ts — do not edit by hand",
-  "toolCount": 758,
+  "toolCount": 759,
   "tools": [
+    {
+      "name": "run_routeros_command",
+      "title": "Run a RouterOS Command (raw CLI)",
+      "risk": "write",
+      "annotations": {
+        "destructiveHint": false,
+        "openWorldHint": false
+      },
+      "description": "Execute ANY single RouterOS / MikroTik CLI command on the device and return its console output — the universal primitive to read or change anything when no dedicated tool fits, for uncommon or bulk operations, or simply when you can't quickly find the specific tool among the catalog. Pass the command EXACTLY as typed in the RouterOS terminal, e.g. `/system identity set name=Router1`, `/ip dns set servers=1.1.1.1,8.8.8.8 allow-remote-requests=yes`, `/ip address print`, `/ip firewall filter print`, `/interface print`, `/ip service print`, `/system resource print`. Works for reads (`… print`) and writes (`… set` / `add` / `remove`). Runs one command per call — call again with a `… print` to verify a change. Prefer a dedicated tool when you know its name (better validation and structured output); use this whenever discovery is the bottleneck. WARNING: the command is run as-is and is NOT validated — it can be destructive (e.g. `/system reset-configuration`, removing the management address), so review it before running. For a stored multi-command script use add_script then run_script.",
+      "inputSchema": {
+        "$schema": "https://json-schema.org/draft/2020-12/schema",
+        "type": "object",
+        "properties": {
+          "command": {
+            "type": "string",
+            "description": "Full RouterOS CLI command exactly as typed, e.g. '/ip address print'"
+          }
+        },
+        "required": ["command"],
+        "additionalProperties": false
+      }
+    },
     {
       "name": "list_interfaces",
       "title": "List All Network Interfaces",

package/schemas/tools/run_routeros_command.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "run_routeros_command",
+  "type": "object",
+  "properties": {
+    "command": {
+      "type": "string",
+      "description": "Full RouterOS CLI command exactly as typed, e.g. '/ip address print'"
+    }
+  },
+  "required": ["command"],
+  "additionalProperties": false
+}