@usex/mikrotik-mcp 3.5.0 → 3.7.0

package/schemas/tools/request_letsencrypt_certificate.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "request_letsencrypt_certificate",
+  "type": "object",
+  "properties": {
+    "dns_name": {
+      "type": "string",
+      "description": "Public DNS name that resolves to this router, e.g. 'vpn.example.com'"
+    }
+  },
+  "required": ["dns_name"],
+  "additionalProperties": false
+}

package/schemas/tools/revoke_wireguard_user.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "revoke_wireguard_user",
+  "type": "object",
+  "properties": {
+    "user": {
+      "type": "string",
+      "description": "The user label used at onboarding"
+    }
+  },
+  "required": ["user"],
+  "additionalProperties": false
+}

package/schemas/tools/run_failover_drill.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "run_failover_drill",
+  "type": "object",
+  "properties": {
+    "target_type": {
+      "default": "interface",
+      "type": "string",
+      "enum": ["interface", "route"]
+    },
+    "target": {
+      "type": "string",
+      "description": "Interface name (e.g. 'ether1-wan') or, for route, a find expression / .id"
+    },
+    "verify_host": {
+      "type": "string",
+      "description": "Host to ping during the outage to confirm the backup path, e.g. '8.8.8.8'"
+    },
+    "ping_count": {
+      "default": 5,
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 50
+    },
+    "confirm": {
+      "default": false,
+      "description": "Must be true to actually run the drill",
+      "type": "boolean"
+    }
+  },
+  "required": ["target_type", "target", "verify_host", "ping_count", "confirm"],
+  "additionalProperties": false
+}

package/schemas/tools/set_dhcp_client.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "set_dhcp_client",
+  "type": "object",
+  "properties": {
+    "interface": {
+      "type": "string"
+    },
+    "add_default_route": {
+      "type": "boolean"
+    },
+    "use_peer_dns": {
+      "type": "boolean"
+    },
+    "use_peer_ntp": {
+      "type": "boolean"
+    },
+    "disabled": {
+      "type": "boolean"
+    }
+  },
+  "required": ["interface"],
+  "additionalProperties": false
+}

package/schemas/tools/set_ip_cloud.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "set_ip_cloud",
+  "type": "object",
+  "properties": {
+    "ddns_enabled": {
+      "description": "Enable (true) or disable (false) the DDNS name",
+      "type": "boolean"
+    },
+    "update_time": {
+      "description": "Also sync the router clock from the cloud",
+      "type": "boolean"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/set_ip_cloud_advanced.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "set_ip_cloud_advanced",
+  "type": "object",
+  "properties": {
+    "use_local_address": {
+      "type": "boolean",
+      "description": "Publish the local address (true) instead of the public address (false)"
+    }
+  },
+  "required": ["use_local_address"],
+  "additionalProperties": false
+}

package/schemas/tools/set_time_policy.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "set_time_policy",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Policy id, e.g. 'kids-bedtime'"
+    },
+    "list": {
+      "default": "parental-devices",
+      "description": "Address-list of the affected devices",
+      "type": "string"
+    },
+    "addresses": {
+      "description": "Device IPs to add to the list",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "block_start": {
+      "default": "22:00",
+      "description": "Daily cut-off time (HH:MM)",
+      "type": "string"
+    },
+    "block_end": {
+      "default": "07:00",
+      "description": "Daily restore time (HH:MM)",
+      "type": "string"
+    },
+    "block_domains": {
+      "description": "Domains to always block via DNS",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "apply": {
+      "default": false,
+      "description": "false = preview (default); true = install",
+      "type": "boolean"
+    }
+  },
+  "required": ["name", "list", "block_start", "block_end", "apply"],
+  "additionalProperties": false
+}

package/schemas/tools/setup_port_knock.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "setup_port_knock",
+  "type": "object",
+  "properties": {
+    "sequence": {
+      "minItems": 2,
+      "type": "array",
+      "items": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 65535
+      },
+      "description": "Secret knock ports, in order, e.g. [7001, 8002, 9003]"
+    },
+    "protect_ports": {
+      "default": "22,8291,8728",
+      "description": "Management ports to hide",
+      "type": "string"
+    },
+    "open_timeout": {
+      "default": "1h",
+      "description": "How long access stays open after the knock",
+      "type": "string"
+    },
+    "stage_timeout": {
+      "default": "10s",
+      "description": "Allowed window between consecutive knocks",
+      "type": "string"
+    },
+    "apply": {
+      "default": false,
+      "description": "false = preview (default); true = install",
+      "type": "boolean"
+    }
+  },
+  "required": ["sequence", "protect_ports", "open_timeout", "stage_timeout", "apply"],
+  "additionalProperties": false
+}

package/schemas/tools/setup_wan_failover.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "setup_wan_failover",
+  "type": "object",
+  "properties": {
+    "primary_gateway": {
+      "type": "string",
+      "description": "Primary WAN gateway IP (or interface name)"
+    },
+    "backup_gateways": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "One or more backup WAN gateways, in failover order"
+    },
+    "check": {
+      "default": "ping",
+      "description": "Gateway health-check method",
+      "type": "string",
+      "enum": ["ping", "arp"]
+    },
+    "comment_prefix": {
+      "default": "wan-failover",
+      "type": "string"
+    },
+    "apply": {
+      "default": false,
+      "description": "false = preview only (default); true = execute",
+      "type": "boolean"
+    }
+  },
+  "required": ["primary_gateway", "backup_gateways", "check", "comment_prefix", "apply"],
+  "additionalProperties": false
+}

package/schemas/tools/setup_wan_loadbalance.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "setup_wan_loadbalance",
+  "type": "object",
+  "properties": {
+    "gateways": {
+      "minItems": 2,
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Two or more WAN gateways to balance across"
+    },
+    "check": {
+      "default": "ping",
+      "description": "Gateway health-check method",
+      "type": "string",
+      "enum": ["ping", "arp"]
+    },
+    "comment": {
+      "default": "wan-ecmp",
+      "type": "string"
+    },
+    "apply": {
+      "default": false,
+      "description": "false = preview only (default); true = execute",
+      "type": "boolean"
+    }
+  },
+  "required": ["gateways", "check", "comment", "apply"],
+  "additionalProperties": false
+}

package/schemas/tools/subscribe_threat_feed.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "subscribe_threat_feed",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Short feed id, e.g. 'spamhaus-drop'"
+    },
+    "url": {
+      "type": "string",
+      "description": "HTTPS URL of a RouterOS .rsc address-list file"
+    },
+    "address_list": {
+      "default": "threat-blocklist",
+      "description": "Address-list to populate",
+      "type": "string"
+    },
+    "interval": {
+      "default": "1h",
+      "description": "How often to refresh the feed",
+      "type": "string"
+    },
+    "drop": {
+      "default": true,
+      "description": "Also add a raw drop rule for the address-list",
+      "type": "boolean"
+    },
+    "apply": {
+      "default": false,
+      "description": "false = preview (default); true = install",
+      "type": "boolean"
+    }
+  },
+  "required": ["name", "url", "address_list", "interval", "drop", "apply"],
+  "additionalProperties": false
+}

package/schemas/tools/test_ssh_from_device.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "test_ssh_from_device",
+  "type": "object",
+  "properties": {
+    "host": {
+      "type": "string",
+      "description": "Remote host the ROUTER should SSH to"
+    },
+    "port": {
+      "default": 22,
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 65535
+    },
+    "user": {
+      "type": "string",
+      "description": "Username on the remote host"
+    },
+    "command": {
+      "default": "/system identity print",
+      "description": "Command to run on the remote host as the connectivity test",
+      "type": "string"
+    }
+  },
+  "required": ["host", "port", "user", "command"],
+  "additionalProperties": false
+}

package/schemas/tools/test_ssh_to_device.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "test_ssh_to_device",
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}

package/schemas/tools/test_ssh_to_host.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "test_ssh_to_host",
+  "type": "object",
+  "properties": {
+    "host": {
+      "type": "string",
+      "description": "Target IP or hostname"
+    },
+    "port": {
+      "default": 22,
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 65535
+    },
+    "username": {
+      "type": "string"
+    },
+    "password": {
+      "description": "Password auth (omit if using a key)",
+      "type": "string"
+    },
+    "key_path": {
+      "description": "Path (on the MCP host) to a private key file",
+      "type": "string"
+    },
+    "key_passphrase": {
+      "type": "string"
+    },
+    "command": {
+      "default": "/system identity print",
+      "description": "Command to run once connected (a harmless RouterOS read by default)",
+      "type": "string"
+    }
+  },
+  "required": ["host", "port", "username", "command"],
+  "additionalProperties": false
+}

package/schemas/tools/tune_wifi_channel.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "tune_wifi_channel",
+  "type": "object",
+  "properties": {
+    "interface": {
+      "type": "string",
+      "description": "Wireless interface, e.g. 'wlan1'"
+    },
+    "duration": {
+      "default": "5",
+      "description": "Survey duration in seconds",
+      "type": "string"
+    },
+    "apply": {
+      "default": false,
+      "description": "false = survey & recommend (default); true = set it",
+      "type": "boolean"
+    }
+  },
+  "required": ["interface", "duration", "apply"],
+  "additionalProperties": false
+}