@usex/mikrotik-mcp 4.24.0 → 5.0.0

package/schemas/tools/get_audit_timeline.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "get_audit_timeline",
+  "type": "object",
+  "properties": {
+    "job_id": {
+      "type": "string",
+      "description": "Which job's history to show."
+    },
+    "device": {
+      "description": "Restrict to one device.",
+      "type": "string"
+    },
+    "limit": {
+      "default": 20,
+      "description": "How many runs to show. Default 20.",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 200
+    }
+  },
+  "required": ["job_id", "limit"],
+  "additionalProperties": false
+}

package/schemas/tools/get_device_capabilities.json

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

package/schemas/tools/get_traffic_flow_settings.json

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

package/schemas/tools/list_alert_rules.json

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

package/schemas/tools/list_attack_incidents.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "list_attack_incidents",
+  "type": "object",
+  "properties": {
+    "hours": {
+      "default": 24,
+      "description": "How far back.",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 8760
+    },
+    "min_confidence": {
+      "description": "Only incidents at or above this confidence.",
+      "type": "string",
+      "enum": ["low", "medium", "high", "confirmed"]
+    },
+    "limit": {
+      "default": 50,
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 500
+    }
+  },
+  "required": ["hours", "limit"],
+  "additionalProperties": false
+}

package/schemas/tools/list_attack_responses.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "list_attack_responses",
+  "type": "object",
+  "properties": {
+    "active_only": {
+      "default": true,
+      "description": "Only blocks still in force.",
+      "type": "boolean"
+    },
+    "limit": {
+      "default": 50,
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 500
+    }
+  },
+  "required": ["active_only", "limit"],
+  "additionalProperties": false
+}

package/schemas/tools/list_policies.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "list_policies",
+  "type": "object",
+  "properties": {
+    "tag": {
+      "description": "Only rules carrying this tag",
+      "type": "string"
+    },
+    "severity": {
+      "description": "Only rules of this severity",
+      "type": "string",
+      "enum": ["critical", "high", "medium", "low", "info"]
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/list_schedules.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "list_schedules",
+  "type": "object",
+  "properties": {
+    "job_id": {
+      "description": "Only this job.",
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/list_traffic_flow_targets.json

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

package/schemas/tools/mute_alert_rule.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "mute_alert_rule",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "duration": {
+      "default": "1h",
+      "description": "How long to stay quiet, e.g. '1h', '30m', '0s'.",
+      "type": "string"
+    }
+  },
+  "required": ["id", "duration"],
+  "additionalProperties": false
+}

package/schemas/tools/plan_rollout.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "plan_rollout",
+  "type": "object",
+  "properties": {
+    "commands": {
+      "anyOf": [
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        {
+          "type": "string"
+        }
+      ],
+      "description": "RouterOS commands to apply to every device (array, or newline-separated)"
+    },
+    "targets": {
+      "anyOf": [
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        {
+          "type": "object",
+          "properties": {
+            "all": {
+              "description": "Every configured, enabled device",
+              "type": "boolean"
+            },
+            "tags": {
+              "description": "Devices carrying ALL of these config tags",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "versionBelow": {
+              "description": "Devices whose RouterOS version is below this, e.g. \"7.14\" (uses the capability cache)",
+              "type": "string"
+            },
+            "exclude": {
+              "description": "Device names to leave out — composable",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "additionalProperties": false
+        }
+      ],
+      "description": "Device names, or a selector like {\"tags\":[\"branch\"]}"
+    },
+    "strategy": {
+      "type": "object",
+      "properties": {
+        "canary": {
+          "description": "Devices in wave 1 (default 1)",
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        "wavePercent": {
+          "description": "Percent of the remaining devices in wave 2 (default 25)",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        },
+        "soakSeconds": {
+          "description": "Wait after each wave's health check before continuing (default 30)",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "onFailure": {
+          "description": "What to do when a wave's gate fails (default halt-and-revert)",
+          "type": "string",
+          "enum": ["halt-and-revert", "halt-and-hold", "continue"]
+        }
+      },
+      "additionalProperties": false
+    },
+    "label": {
+      "description": "What this change is, e.g. \"ntp servers\"",
+      "type": "string"
+    }
+  },
+  "required": ["commands", "targets"],
+  "additionalProperties": false
+}

package/schemas/tools/refresh_device_capabilities.json

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

package/schemas/tools/remove_alert_rule.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "remove_alert_rule",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}

package/schemas/tools/remove_schedule.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "remove_schedule",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "The job id to remove."
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}

package/schemas/tools/remove_traffic_flow_target.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "remove_traffic_flow_target",
+  "type": "object",
+  "properties": {
+    "dst_address": {
+      "type": "string",
+      "description": "Collector address of the target to remove"
+    }
+  },
+  "required": ["dst_address"],
+  "additionalProperties": false
+}

package/schemas/tools/rollout_status.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "rollout_status",
+  "type": "object",
+  "properties": {
+    "rollout_id": {
+      "description": "Rollout id from start_rollout",
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/run_policy_check.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "run_policy_check",
+  "type": "object",
+  "properties": {
+    "tag": {
+      "description": "Only evaluate rules carrying this tag",
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/run_schedule_now.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "run_schedule_now",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "The job id to run."
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}

package/schemas/tools/scan_for_attacks.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "scan_for_attacks",
+  "type": "object",
+  "properties": {
+    "devices": {
+      "description": "Limit to these devices (default: all).",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "window_minutes": {
+      "description": "How far back to read. Default from config (10).",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 1440
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/set_traffic_flow_settings.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "set_traffic_flow_settings",
+  "type": "object",
+  "properties": {
+    "enabled": {
+      "description": "Turn flow export on or off",
+      "type": "boolean"
+    },
+    "interfaces": {
+      "description": "Interface list, or \"all\" (default). e.g. \"ether1,bridge\"",
+      "type": "string"
+    },
+    "cache_entries": {
+      "description": "Flow cache size, e.g. \"4k\", \"16k\" — bound on device memory",
+      "type": "string"
+    },
+    "active_flow_timeout": {
+      "description": "e.g. \"30m\" — report long flows sooner",
+      "type": "string"
+    },
+    "inactive_flow_timeout": {
+      "description": "e.g. \"15s\"",
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/simulate_change.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "simulate_change",
+  "type": "object",
+  "properties": {
+    "src_address": {
+      "type": "string",
+      "description": "Source IPv4 address, e.g. \"192.168.88.50\""
+    },
+    "dst_address": {
+      "type": "string",
+      "description": "Destination IPv4 address, e.g. \"8.8.8.8\""
+    },
+    "protocol": {
+      "default": "tcp",
+      "description": "\"tcp\", \"udp\", \"icmp\" or a protocol number",
+      "type": "string"
+    },
+    "src_port": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 65535
+    },
+    "dst_port": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 65535
+    },
+    "in_interface": {
+      "type": "string",
+      "description": "Interface the packet arrives on, e.g. `bridge`"
+    },
+    "connection_state": {
+      "default": "new",
+      "description": "DECLARED, not inferred — this model has no connection-tracking table",
+      "type": "string",
+      "enum": ["new", "established", "related", "invalid"]
+    },
+    "connection_mark": {
+      "type": "string"
+    },
+    "changes": {
+      "anyOf": [
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        {
+          "type": "string"
+        }
+      ],
+      "description": "Proposed export lines, e.g. `/ip firewall filter` then `add action=drop ...`"
+    },
+    "snapshot_id": {
+      "type": "string"
+    },
+    "config_text": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "src_address",
+    "dst_address",
+    "protocol",
+    "in_interface",
+    "connection_state",
+    "changes"
+  ],
+  "additionalProperties": false
+}

package/schemas/tools/simulate_packet.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "simulate_packet",
+  "type": "object",
+  "properties": {
+    "src_address": {
+      "type": "string",
+      "description": "Source IPv4 address, e.g. \"192.168.88.50\""
+    },
+    "dst_address": {
+      "type": "string",
+      "description": "Destination IPv4 address, e.g. \"8.8.8.8\""
+    },
+    "protocol": {
+      "default": "tcp",
+      "description": "\"tcp\", \"udp\", \"icmp\" or a protocol number",
+      "type": "string"
+    },
+    "src_port": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 65535
+    },
+    "dst_port": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 65535
+    },
+    "in_interface": {
+      "type": "string",
+      "description": "Interface the packet arrives on, e.g. `bridge`"
+    },
+    "connection_state": {
+      "default": "new",
+      "description": "DECLARED, not inferred — this model has no connection-tracking table",
+      "type": "string",
+      "enum": ["new", "established", "related", "invalid"]
+    },
+    "connection_mark": {
+      "type": "string"
+    },
+    "snapshot_id": {
+      "description": "Evaluate against a stored snapshot",
+      "type": "string"
+    },
+    "config_text": {
+      "description": "Evaluate against raw `/export` text",
+      "type": "string"
+    }
+  },
+  "required": ["src_address", "dst_address", "protocol", "in_interface", "connection_state"],
+  "additionalProperties": false
+}

package/schemas/tools/simulate_suite.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "simulate_suite",
+  "type": "object",
+  "properties": {
+    "packets": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "What this flow is, e.g. \"LAN → internet\""
+          },
+          "src_address": {
+            "type": "string"
+          },
+          "dst_address": {
+            "type": "string"
+          },
+          "protocol": {
+            "default": "tcp",
+            "type": "string"
+          },
+          "src_port": {
+            "type": "integer",
+            "minimum": -9007199254740991,
+            "maximum": 9007199254740991
+          },
+          "dst_port": {
+            "type": "integer",
+            "minimum": -9007199254740991,
+            "maximum": 9007199254740991
+          },
+          "in_interface": {
+            "type": "string"
+          },
+          "connection_state": {
+            "default": "new",
+            "type": "string",
+            "enum": ["new", "established", "related", "invalid"]
+          },
+          "expect": {
+            "type": "string",
+            "enum": ["accept", "drop", "reject"],
+            "description": "The verdict this flow must get"
+          }
+        },
+        "required": [
+          "name",
+          "src_address",
+          "dst_address",
+          "protocol",
+          "in_interface",
+          "connection_state",
+          "expect"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "snapshot_id": {
+      "type": "string"
+    },
+    "config_text": {
+      "type": "string"
+    }
+  },
+  "required": ["packets"],
+  "additionalProperties": false
+}

package/schemas/tools/start_flow_collector.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "start_flow_collector",
+  "type": "object",
+  "properties": {
+    "port": {
+      "description": "UDP port to listen on (defaults to the configured flows.port, 2055)",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    }
+  },
+  "additionalProperties": false
+}