@usex/mikrotik-mcp 5.19.0 → 5.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/README.md +180 -8
  2. package/dist/cli.js +3452 -729
  3. package/dist/index.js +148 -27
  4. package/dist/shared/{library-ppnv0f07.js → library-588vnctn.js} +1 -1
  5. package/dist/shared/{library-7wcv2ckk.js → library-6tvh3gq1.js} +2837 -545
  6. package/dist/shared/{library-tqrvrykj.js → library-g8far2nz.js} +1 -1
  7. package/dist/shared/{library-f3be6g03.js → library-k6m2bxjr.js} +1 -1
  8. package/dist/shared/{library-z7qsdq88.js → library-wj2xfx8h.js} +1 -1
  9. package/dist/ui/aaa.html +8 -8
  10. package/dist/ui/connected-devices.html +8 -8
  11. package/dist/ui/dashboard.html +16 -16
  12. package/dist/ui/fabric.html +11 -11
  13. package/dist/ui/firewall-audit.html +8 -8
  14. package/dist/ui/firewall.html +9 -9
  15. package/dist/ui/interfaces.html +8 -8
  16. package/dist/ui/investigations.html +11 -11
  17. package/dist/ui/observability.html +66 -62
  18. package/dist/ui/operations.html +11 -11
  19. package/dist/ui/records.html +12 -12
  20. package/dist/ui/reports.html +11 -11
  21. package/dist/ui/round-trip.html +11 -11
  22. package/dist/ui/service-health.html +11 -11
  23. package/package.json +24 -23
  24. package/prompts/audit-routeros-containers.md +27 -0
  25. package/prompts/audit-vlan-segmentation.md +31 -0
  26. package/prompts/setup-guest-wifi.md +23 -24
  27. package/prompts/setup-routeros-container.md +36 -0
  28. package/prompts/setup-v2ray-container-proxy.md +68 -194
  29. package/prompts/setup-vlan-network.md +27 -33
  30. package/schemas/README.md +1 -1
  31. package/schemas/devtools-manifest.json +327 -16
  32. package/schemas/tool-catalog.json +898 -109
  33. package/schemas/tools/add_container.json +42 -30
  34. package/schemas/tools/add_container_env.json +3 -4
  35. package/schemas/tools/add_container_mount.json +10 -4
  36. package/schemas/tools/apply_service_routing.json +23 -0
  37. package/schemas/tools/arm_service_routing.json +23 -0
  38. package/schemas/tools/configure_flight_recorder.json +30 -0
  39. package/schemas/tools/create_service_routing.json +91 -0
  40. package/schemas/tools/design_network_segment.json +22 -6
  41. package/schemas/tools/destroy_recovery_lab.json +18 -0
  42. package/schemas/tools/disconnect_ovpn_session.json +20 -0
  43. package/schemas/tools/export_network_incident.json +14 -0
  44. package/schemas/tools/freeze_network_incident.json +14 -0
  45. package/schemas/tools/get_container.json +11 -4
  46. package/schemas/tools/get_flight_recorder.json +7 -0
  47. package/schemas/tools/get_recovery_lab.json +7 -0
  48. package/schemas/tools/get_routeros_container_guide.json +22 -0
  49. package/schemas/tools/get_vlan_segmentation_guide.json +14 -0
  50. package/schemas/tools/list_container_envs.json +1 -1
  51. package/schemas/tools/list_container_mounts.json +7 -2
  52. package/schemas/tools/list_containers.json +2 -4
  53. package/schemas/tools/list_ovpn_sessions.json +7 -0
  54. package/schemas/tools/list_service_routing.json +7 -0
  55. package/schemas/tools/poll_recovery_lab.json +14 -0
  56. package/schemas/tools/prepare_recovery_lab.json +23 -0
  57. package/schemas/tools/preview_service_routing.json +23 -0
  58. package/schemas/tools/probe_service_routing.json +14 -0
  59. package/schemas/tools/recovery_lab_inventory.json +7 -0
  60. package/schemas/tools/remove_container.json +11 -4
  61. package/schemas/tools/remove_container_env.json +7 -3
  62. package/schemas/tools/remove_container_mount.json +18 -2
  63. package/schemas/tools/service_routing_address_page.json +19 -0
  64. package/schemas/tools/service_routing_inventory.json +7 -0
  65. package/schemas/tools/service_routing_traffic.json +14 -0
  66. package/schemas/tools/set_container_config.json +4 -6
  67. package/schemas/tools/start_container.json +11 -4
  68. package/schemas/tools/start_recovery_lab.json +18 -0
  69. package/schemas/tools/stop_container.json +11 -4
  70. package/schemas/tools/update_container.json +46 -6
  71. /package/dist/shared/{cli-j07tbrke.js → cli-h065ap70.js} +0 -0
  72. /package/dist/shared/{cli-s0rxncz4.js → cli-se3tgt7t.js} +0 -0
  73. /package/dist/shared/{cli-y00nwzxx.js → cli-t311px0m.js} +0 -0
  74. /package/dist/shared/{cli-gtq5bw8q.js → cli-wf9a7qjm.js} +0 -0
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "version": "5.19.0",
3
+ "version": "5.21.0",
4
4
  "generated": "by scripts/gen-schemas.ts — do not edit by hand",
5
- "toolCount": 937,
5
+ "toolCount": 960,
6
6
  "tools": [
7
7
  {
8
8
  "name": "create_client_check",
@@ -948,6 +948,562 @@
948
948
  "additionalProperties": false
949
949
  }
950
950
  },
951
+ {
952
+ "name": "list_service_routing",
953
+ "title": "List Service Routing Policies",
954
+ "risk": "read",
955
+ "annotations": {
956
+ "readOnlyHint": true,
957
+ "idempotentHint": true,
958
+ "openWorldHint": false
959
+ },
960
+ "description": "Read persistent domain routing policies, path evidence, primary exit, history and authorization expiry for this router. No probes or router changes.",
961
+ "inputSchema": {
962
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
963
+ "type": "object",
964
+ "properties": {},
965
+ "additionalProperties": false
966
+ }
967
+ },
968
+ {
969
+ "name": "service_routing_inventory",
970
+ "title": "Inspect Router Routing Configuration",
971
+ "risk": "read",
972
+ "annotations": {
973
+ "readOnlyHint": true,
974
+ "idempotentHint": true,
975
+ "openWorldHint": false
976
+ },
977
+ "description": "Read live IPv4/IPv6 routes, ordered mangle and routing rules, address lists, tables, VRFs and filter rules independently of saved MCP policies. Includes dynamic/disabled entries, per-section failures and observation timestamps; bounded reads, 20-second cache. Missing data is not zero. Also lists enabled FIB exits and approved HTTPS aliases. Table presence is not path health; HTTPS exit probes require a matching VRF. No router changes.",
978
+ "inputSchema": {
979
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
980
+ "type": "object",
981
+ "properties": {},
982
+ "additionalProperties": false
983
+ }
984
+ },
985
+ {
986
+ "name": "service_routing_address_page",
987
+ "title": "Read Routing Address List Page",
988
+ "risk": "read",
989
+ "annotations": {
990
+ "readOnlyHint": true,
991
+ "idempotentHint": true,
992
+ "openWorldHint": false
993
+ },
994
+ "description": "Read the next bounded page of this router's IPv4 or IPv6 address-list members. Use nextOffset from service_routing_inventory or the preceding page. At most 200 rows per request; live lists may change between pages. Read-only, no router changes.",
995
+ "inputSchema": {
996
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
997
+ "type": "object",
998
+ "properties": {
999
+ "family": {
1000
+ "type": "string",
1001
+ "enum": ["ipv4", "ipv6"]
1002
+ },
1003
+ "offset": {
1004
+ "default": 0,
1005
+ "type": "integer",
1006
+ "minimum": 0,
1007
+ "maximum": 1000000
1008
+ }
1009
+ },
1010
+ "required": ["family", "offset"],
1011
+ "additionalProperties": false
1012
+ }
1013
+ },
1014
+ {
1015
+ "name": "service_routing_traffic",
1016
+ "title": "Read Service Routing Traffic",
1017
+ "risk": "read",
1018
+ "annotations": {
1019
+ "readOnlyHint": true,
1020
+ "idempotentHint": true,
1021
+ "openWorldHint": false
1022
+ },
1023
+ "description": "Read the exact active MCP-owned routing mark's client-to-service byte and packet counters for one saved policy. Decimal strings preserve 64-bit totals. Four-second cache; missing, disabled or modified rules are unavailable, not zero. Excludes return/download traffic and does not prove delivery, DNS coverage or billing usage. No reset or router change.",
1024
+ "inputSchema": {
1025
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1026
+ "type": "object",
1027
+ "properties": {
1028
+ "id": {
1029
+ "type": "string",
1030
+ "format": "uuid",
1031
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
1032
+ }
1033
+ },
1034
+ "required": ["id"],
1035
+ "additionalProperties": false
1036
+ }
1037
+ },
1038
+ {
1039
+ "name": "create_service_routing",
1040
+ "title": "Create Service Routing Draft",
1041
+ "risk": "write",
1042
+ "annotations": {
1043
+ "destructiveHint": false,
1044
+ "openWorldHint": false
1045
+ },
1046
+ "description": "Save a single-family exact domain or *.example.com route for explicit client subnets. The wildcard excludes the apex and requires client DNS through this router, existing remote DNS, RouterOS 7.17+ and dnsLearningConfirmed. Wildcard FWD bypasses adlists for matching DNS queries. HTTPS target is optional for manual routing, required for health probes/failover; when domain is absent use the approved target's host (legacy). Shared CDN IPs can affect other services. No router change until preview and explicit apply. Never infer authorization from a draft.",
1047
+ "inputSchema": {
1048
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1049
+ "type": "object",
1050
+ "properties": {
1051
+ "name": {
1052
+ "type": "string",
1053
+ "minLength": 1,
1054
+ "maxLength": 80
1055
+ },
1056
+ "target": {
1057
+ "description": "Optional approved HTTPS probe alias; legacy drafts without domain route this alias's exact host",
1058
+ "type": "string",
1059
+ "minLength": 1,
1060
+ "maxLength": 64,
1061
+ "pattern": "^[a-zA-Z0-9_.-]+$"
1062
+ },
1063
+ "domain": {
1064
+ "description": "Exact domain or *.example.com (subdomains only, not the apex). Wildcards need client DNS through this router.",
1065
+ "type": "string",
1066
+ "maxLength": 253
1067
+ },
1068
+ "dnsLearningConfirmed": {
1069
+ "description": "For wildcard only: confirms clients use this router DNS, shared-IP scope and FWD adlist bypass are understood. Does not enable or intercept DNS.",
1070
+ "type": "boolean"
1071
+ },
1072
+ "precedence": {
1073
+ "description": "Explicitly allow this scoped policy before existing routing rules. Preview still binds their full configuration; FastTrack is never bypassed.",
1074
+ "type": "string",
1075
+ "enum": ["before-existing"]
1076
+ },
1077
+ "family": {
1078
+ "type": "string",
1079
+ "enum": ["ipv4", "ipv6"]
1080
+ },
1081
+ "sources": {
1082
+ "minItems": 1,
1083
+ "maxItems": 8,
1084
+ "type": "array",
1085
+ "items": {
1086
+ "type": "string"
1087
+ }
1088
+ },
1089
+ "tables": {
1090
+ "minItems": 1,
1091
+ "maxItems": 3,
1092
+ "type": "array",
1093
+ "items": {
1094
+ "type": "string",
1095
+ "minLength": 1,
1096
+ "maxLength": 64,
1097
+ "pattern": "^[a-zA-Z0-9_.-]+$"
1098
+ }
1099
+ },
1100
+ "primary": {
1101
+ "type": "string",
1102
+ "minLength": 1,
1103
+ "maxLength": 64,
1104
+ "pattern": "^[a-zA-Z0-9_.-]+$"
1105
+ },
1106
+ "maxLatencyMs": {
1107
+ "default": 5000,
1108
+ "type": "integer",
1109
+ "minimum": 100,
1110
+ "maximum": 15000
1111
+ },
1112
+ "failuresBeforeSwitch": {
1113
+ "default": 3,
1114
+ "type": "integer",
1115
+ "minimum": 2,
1116
+ "maximum": 10
1117
+ },
1118
+ "cooldownSeconds": {
1119
+ "default": 300,
1120
+ "type": "integer",
1121
+ "minimum": 120,
1122
+ "maximum": 3600
1123
+ }
1124
+ },
1125
+ "required": [
1126
+ "name",
1127
+ "family",
1128
+ "sources",
1129
+ "tables",
1130
+ "primary",
1131
+ "maxLatencyMs",
1132
+ "failuresBeforeSwitch",
1133
+ "cooldownSeconds"
1134
+ ],
1135
+ "additionalProperties": false
1136
+ }
1137
+ },
1138
+ {
1139
+ "name": "probe_service_routing",
1140
+ "title": "Probe Service Exits",
1141
+ "risk": "read",
1142
+ "annotations": {
1143
+ "readOnlyHint": true,
1144
+ "idempotentHint": true,
1145
+ "openWorldHint": false
1146
+ },
1147
+ "description": "Run bounded, IP-approved HTTPS HEAD fetches from the router through matching VRFs, certificate validation on, redirects off. No files/bodies stored. Table-only exits remain UNKNOWN. SSH overhead is included; not end-client reachability or throughput proof.",
1148
+ "inputSchema": {
1149
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1150
+ "type": "object",
1151
+ "properties": {
1152
+ "id": {
1153
+ "type": "string",
1154
+ "format": "uuid",
1155
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
1156
+ }
1157
+ },
1158
+ "required": ["id"],
1159
+ "additionalProperties": false
1160
+ }
1161
+ },
1162
+ {
1163
+ "name": "preview_service_routing",
1164
+ "title": "Preview Service Routing Change",
1165
+ "risk": "read",
1166
+ "annotations": {
1167
+ "readOnlyHint": true,
1168
+ "idempotentHint": true,
1169
+ "openWorldHint": false
1170
+ },
1171
+ "description": "Read router state and save a two-minute state-bound preview for applying/switching or removing owned rules. Reject FastTrack, overlapping wildcard DNS and foreign routing conflicts unless before-existing precedence was explicitly selected. Wildcard plans add an owned DNS FWD learner, not DNS interception. Does not create exits, NAT or change the router until apply.",
1172
+ "inputSchema": {
1173
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1174
+ "type": "object",
1175
+ "properties": {
1176
+ "id": {
1177
+ "type": "string",
1178
+ "format": "uuid",
1179
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
1180
+ },
1181
+ "table": {
1182
+ "type": "string",
1183
+ "minLength": 1,
1184
+ "maxLength": 64
1185
+ },
1186
+ "remove": {
1187
+ "default": false,
1188
+ "type": "boolean"
1189
+ }
1190
+ },
1191
+ "required": ["id", "table", "remove"],
1192
+ "additionalProperties": false
1193
+ }
1194
+ },
1195
+ {
1196
+ "name": "apply_service_routing",
1197
+ "title": "Apply Approved Service Routing Preview",
1198
+ "risk": "write",
1199
+ "annotations": {
1200
+ "destructiveHint": false,
1201
+ "openWorldHint": false
1202
+ },
1203
+ "description": "After explicit user confirmation, apply the exact fresh preview with a backup, exclusive Safe Mode and read-back. Router DNS maintains the owned destination list. Does not touch output/input chains. An ambiguous write is never retried; inspect router state. An apply pauses automatic failover.",
1204
+ "inputSchema": {
1205
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1206
+ "type": "object",
1207
+ "properties": {
1208
+ "id": {
1209
+ "type": "string",
1210
+ "format": "uuid",
1211
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
1212
+ },
1213
+ "planId": {
1214
+ "type": "string",
1215
+ "format": "uuid",
1216
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
1217
+ },
1218
+ "confirm": {
1219
+ "default": false,
1220
+ "type": "boolean"
1221
+ }
1222
+ },
1223
+ "required": ["id", "planId", "confirm"],
1224
+ "additionalProperties": false
1225
+ }
1226
+ },
1227
+ {
1228
+ "name": "arm_service_routing",
1229
+ "title": "Authorize Time-Limited Service Failover",
1230
+ "risk": "write",
1231
+ "annotations": {
1232
+ "destructiveHint": false,
1233
+ "openWorldHint": false
1234
+ },
1235
+ "description": "Explicitly authorize automatic switching between saved exits for 1-60 minutes, or pause with 0. Requires fresh passing VRF evidence for every exit, consecutive definite failures and cooldown; UNKNOWN never triggers a switch. Expiry stops automation but retains the current route. No new exits or global policy rewrites.",
1236
+ "inputSchema": {
1237
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1238
+ "type": "object",
1239
+ "properties": {
1240
+ "id": {
1241
+ "type": "string",
1242
+ "format": "uuid",
1243
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
1244
+ },
1245
+ "minutes": {
1246
+ "type": "integer",
1247
+ "minimum": 0,
1248
+ "maximum": 60
1249
+ },
1250
+ "confirm": {
1251
+ "default": false,
1252
+ "type": "boolean"
1253
+ }
1254
+ },
1255
+ "required": ["id", "minutes", "confirm"],
1256
+ "additionalProperties": false
1257
+ }
1258
+ },
1259
+ {
1260
+ "name": "get_flight_recorder",
1261
+ "title": "Read Network Flight Recorder",
1262
+ "risk": "read",
1263
+ "annotations": {
1264
+ "readOnlyHint": true,
1265
+ "idempotentHint": true,
1266
+ "openWorldHint": false
1267
+ },
1268
+ "description": "Read bounded persistent telemetry, off-router log metadata, capture gaps and frozen incidents for this router. No active probes. Times are host receipt times; correlation never proves cause, identity or a network outage.",
1269
+ "inputSchema": {
1270
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1271
+ "type": "object",
1272
+ "properties": {},
1273
+ "additionalProperties": false
1274
+ }
1275
+ },
1276
+ {
1277
+ "name": "configure_flight_recorder",
1278
+ "title": "Configure Network Flight Recorder",
1279
+ "risk": "write",
1280
+ "annotations": {
1281
+ "destructiveHint": false,
1282
+ "openWorldHint": false
1283
+ },
1284
+ "description": "Explicitly enable/disable periodic read-only router collection and local retention. No router configuration writes. Stores bounded resources, interface state, classified log metadata and MCP write/failure metadata; no raw messages or credentials. Requires the MCP process to stay running. SSH polling can miss logs; not a lossless syslog service.",
1285
+ "inputSchema": {
1286
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1287
+ "type": "object",
1288
+ "properties": {
1289
+ "enabled": {
1290
+ "type": "boolean"
1291
+ },
1292
+ "intervalSeconds": {
1293
+ "default": 60,
1294
+ "type": "integer",
1295
+ "minimum": 30,
1296
+ "maximum": 300
1297
+ },
1298
+ "windowMinutes": {
1299
+ "default": 60,
1300
+ "type": "integer",
1301
+ "minimum": 15,
1302
+ "maximum": 360
1303
+ },
1304
+ "retentionDays": {
1305
+ "default": 7,
1306
+ "type": "integer",
1307
+ "minimum": 1,
1308
+ "maximum": 30
1309
+ }
1310
+ },
1311
+ "required": ["enabled", "intervalSeconds", "windowMinutes", "retentionDays"],
1312
+ "additionalProperties": false
1313
+ }
1314
+ },
1315
+ {
1316
+ "name": "freeze_network_incident",
1317
+ "title": "Freeze Network Incident Evidence",
1318
+ "risk": "write",
1319
+ "annotations": {
1320
+ "destructiveHint": false,
1321
+ "openWorldHint": false
1322
+ },
1323
+ "description": "Preserve this router's available rolling evidence plus two minutes of future samples when recording is enabled. Local operation only. Empty history stays empty; cannot recover past logs. Maximum 30 incidents, configured age retention.",
1324
+ "inputSchema": {
1325
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1326
+ "type": "object",
1327
+ "properties": {
1328
+ "title": {
1329
+ "type": "string",
1330
+ "minLength": 1,
1331
+ "maxLength": 120
1332
+ }
1333
+ },
1334
+ "required": ["title"],
1335
+ "additionalProperties": false
1336
+ }
1337
+ },
1338
+ {
1339
+ "name": "export_network_incident",
1340
+ "title": "Export Network Incident Evidence",
1341
+ "risk": "read",
1342
+ "annotations": {
1343
+ "readOnlyHint": true,
1344
+ "idempotentHint": true,
1345
+ "openWorldHint": false
1346
+ },
1347
+ "description": "Export a device-scoped frozen incident with coverage gaps and separate router/receive timestamps. No raw logs or command bodies. Review device/interface names before sharing. Do not attribute an attack to a user based only on these observations.",
1348
+ "inputSchema": {
1349
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1350
+ "type": "object",
1351
+ "properties": {
1352
+ "id": {
1353
+ "type": "string",
1354
+ "format": "uuid",
1355
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
1356
+ }
1357
+ },
1358
+ "required": ["id"],
1359
+ "additionalProperties": false
1360
+ }
1361
+ },
1362
+ {
1363
+ "name": "get_recovery_lab",
1364
+ "title": "Read Recovery Lab",
1365
+ "risk": "read",
1366
+ "annotations": {
1367
+ "readOnlyHint": true,
1368
+ "idempotentHint": true,
1369
+ "openWorldHint": false
1370
+ },
1371
+ "description": "Read device-scoped recovery rehearsals and last-known runner evidence. Local only, no router or runner contact. A passed portable subset is not proof of a full physical-router restore or production upgrade safety.",
1372
+ "inputSchema": {
1373
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1374
+ "type": "object",
1375
+ "properties": {},
1376
+ "additionalProperties": false
1377
+ }
1378
+ },
1379
+ {
1380
+ "name": "recovery_lab_inventory",
1381
+ "title": "Inspect Recovery Lab Inputs",
1382
+ "risk": "read",
1383
+ "annotations": {
1384
+ "readOnlyHint": true,
1385
+ "idempotentHint": true,
1386
+ "openWorldHint": false
1387
+ },
1388
+ "description": "List this router's local snapshots and read the administrator-configured runner's isolation claims and pinned CHR images. Does not provision VMs or transmit snapshots. Runner must be separately installed; no fallback to production routers.",
1389
+ "inputSchema": {
1390
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1391
+ "type": "object",
1392
+ "properties": {},
1393
+ "additionalProperties": false
1394
+ }
1395
+ },
1396
+ {
1397
+ "name": "prepare_recovery_lab",
1398
+ "title": "Prepare Isolated Recovery Rehearsal",
1399
+ "risk": "write",
1400
+ "annotations": {
1401
+ "destructiveHint": false,
1402
+ "openWorldHint": false
1403
+ },
1404
+ "description": "Build a local immutable preview from an existing device-owned snapshot: allowlisted additive literal commands only, coverage counts, no secrets/scripts/management settings. No raw export upload, VM creation or router contact. Unknown scopes are excluded and remain untested. Preview expires in ten minutes.",
1405
+ "inputSchema": {
1406
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1407
+ "type": "object",
1408
+ "properties": {
1409
+ "snapshotId": {
1410
+ "type": "string",
1411
+ "minLength": 1,
1412
+ "maxLength": 100
1413
+ },
1414
+ "version": {
1415
+ "type": "string",
1416
+ "pattern": "^7\\.\\d+(?:\\.\\d+)?(?:beta\\d+|rc\\d+)?$"
1417
+ },
1418
+ "mode": {
1419
+ "default": "restore",
1420
+ "type": "string",
1421
+ "enum": ["restore", "upgrade"]
1422
+ }
1423
+ },
1424
+ "required": ["snapshotId", "version", "mode"],
1425
+ "additionalProperties": false
1426
+ }
1427
+ },
1428
+ {
1429
+ "name": "start_recovery_lab",
1430
+ "title": "Start Approved Recovery Rehearsal",
1431
+ "risk": "write",
1432
+ "annotations": {
1433
+ "destructiveHint": false,
1434
+ "openWorldHint": false
1435
+ },
1436
+ "description": "Only after explicit approval, transmit the reviewed portable subset to the pinned isolated runner and request a disposable 15-minute CHR lab. Revalidate snapshot and runner capabilities. No production router I/O. An ambiguous request is never retried; poll the same ID. Requires a separately deployed runner implementing the documented protocol.",
1437
+ "inputSchema": {
1438
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1439
+ "type": "object",
1440
+ "properties": {
1441
+ "id": {
1442
+ "type": "string",
1443
+ "format": "uuid",
1444
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
1445
+ },
1446
+ "confirm": {
1447
+ "default": false,
1448
+ "type": "boolean"
1449
+ }
1450
+ },
1451
+ "required": ["id", "confirm"],
1452
+ "additionalProperties": false
1453
+ }
1454
+ },
1455
+ {
1456
+ "name": "poll_recovery_lab",
1457
+ "title": "Read Recovery Runner Evidence",
1458
+ "risk": "read",
1459
+ "annotations": {
1460
+ "readOnlyHint": true,
1461
+ "idempotentHint": true,
1462
+ "openWorldHint": false
1463
+ },
1464
+ "description": "Poll the exact existing rehearsal ID on its original approved runner. Check identity, request hash, target version, isolation, distinct checks and cleanup. Full pass requires authenticated boot/import/readback/reboot/isolation; excluded scopes and hardware remain untested. No write retry.",
1465
+ "inputSchema": {
1466
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1467
+ "type": "object",
1468
+ "properties": {
1469
+ "id": {
1470
+ "type": "string",
1471
+ "format": "uuid",
1472
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
1473
+ }
1474
+ },
1475
+ "required": ["id"],
1476
+ "additionalProperties": false
1477
+ }
1478
+ },
1479
+ {
1480
+ "name": "destroy_recovery_lab",
1481
+ "title": "Destroy Owned Disposable Lab",
1482
+ "risk": "destructive",
1483
+ "annotations": {
1484
+ "destructiveHint": true,
1485
+ "idempotentHint": true,
1486
+ "openWorldHint": false
1487
+ },
1488
+ "description": "After explicit confirmation, request destruction of the VM/resources belonging only to this submitted rehearsal ID on its original runner. Local evidence is retained. Requires verified destruction response; never destroys production devices or accepts arbitrary VM IDs.",
1489
+ "inputSchema": {
1490
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1491
+ "type": "object",
1492
+ "properties": {
1493
+ "id": {
1494
+ "type": "string",
1495
+ "format": "uuid",
1496
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
1497
+ },
1498
+ "confirm": {
1499
+ "default": false,
1500
+ "type": "boolean"
1501
+ }
1502
+ },
1503
+ "required": ["id", "confirm"],
1504
+ "additionalProperties": false
1505
+ }
1506
+ },
951
1507
  {
952
1508
  "name": "inspect_flow_path",
953
1509
  "title": "Inspect Exported Client Flow Path",
@@ -1485,7 +2041,7 @@
1485
2041
  "destructiveHint": false,
1486
2042
  "openWorldHint": false
1487
2043
  },
1488
- "description": "Apply explicitly user-approved MCP host settings, not RouterOS configuration. First get_mcp_settings_schema and preview_mcp_settings; supply that revision and confirm=true. Backs up the config locally, saves atomically and arms a 30–600s in-process rollback (default 60s). Conflicts with another pending dashboard/tool edit are rejected. Verify configured values with get_mcp_settings, then confirm_mcp_settings before the deadline or rollback_mcp_settings. Never restart while pending: the rollback timer does not survive process exit. Restart-required settings are only fully activated after confirmation and a separate operator-controlled restart. Does not widen access scopes or change router addresses/credentials.",
2044
+ "description": "Apply explicitly user-approved MCP host settings, not RouterOS configuration. First get_mcp_settings_schema and preview_mcp_settings; supply that revision and confirm=true. Backs up the source JSON, persists the full config and arms a 30–600s in-process rollback (default 60s). Normal files use atomic replacement; a single-file Docker bind mount uses a backed-up in-place write that is not crash-atomic. Conflicts with another pending dashboard/tool edit are rejected. Verify configured values with get_mcp_settings, then confirm_mcp_settings before the deadline or rollback_mcp_settings. Never restart while pending: the rollback timer does not survive process exit. Restart-required settings are only fully activated after confirmation and a separate operator-controlled restart. Does not widen access scopes or change router addresses/credentials.",
1489
2045
  "inputSchema": {
1490
2046
  "$schema": "https://json-schema.org/draft/2020-12/schema",
1491
2047
  "type": "object",
@@ -2064,7 +2620,7 @@
2064
2620
  "destructiveHint": false,
2065
2621
  "openWorldHint": false
2066
2622
  },
2067
- "description": "Creates an 802.1Q VLAN sub-interface (`/interface vlan`) on a specified parent physical or bridge interface. Use this to segment layer-2 traffic by VLAN ID (1–4094); set `use_service_tag=true` for 802.1ad QinQ double-tagging. For listing existing VLAN interfaces use `list_vlan_interfaces`; for editing an existing VLAN use `update_vlan_interface`. Returns the created interface's full detail including its name, which is the identifier accepted by `get_vlan_interface`, `update_vlan_interface`, and `remove_vlan_interface`. ARP mode accepts: enabled (default), disabled, proxy-arp, reply-only.",
2623
+ "description": "Creates an 802.1Q VLAN sub-interface (`/interface vlan`) on a specified parent physical or bridge interface. This creates only a VLAN sub-interface, NOT bridge port membership, PVID, firewall isolation or SSID mapping. For a bridge member use the bridge as routed parent; read get_vlan_segmentation_guide before migration. Set `use_service_tag=true` for 802.1ad QinQ double-tagging. For listing existing VLAN interfaces use `list_vlan_interfaces`; for editing an existing VLAN use `update_vlan_interface`. Returns the created interface's full detail including its name, which is the identifier accepted by `get_vlan_interface`, `update_vlan_interface`, and `remove_vlan_interface`. ARP mode accepts: enabled (default), disabled, proxy-arp, reply-only.",
2068
2624
  "inputSchema": {
2069
2625
  "$schema": "https://json-schema.org/draft/2020-12/schema",
2070
2626
  "type": "object",
@@ -2277,15 +2833,47 @@
2277
2833
  "additionalProperties": false
2278
2834
  }
2279
2835
  },
2836
+ {
2837
+ "name": "get_vlan_segmentation_guide",
2838
+ "title": "Read VLAN Segmentation Knowledge",
2839
+ "risk": "read",
2840
+ "annotations": {
2841
+ "readOnlyHint": true,
2842
+ "idempotentHint": true,
2843
+ "openWorldHint": false
2844
+ },
2845
+ "description": "Read the RouterOS homelab VLAN design guide before VLAN, guest Wi-Fi, IoT or management-network work. Covers bridge CPU/tagged/untagged/PVID, dual-stack IPv4/IPv6 isolation, SSIDs/CAPsMAN, VPN return routing, Safe Mode/rollback, validation and clean Device/Group/Shared memory. Reference only; no router contact, live audit, memory write or authorization. Select a topic for concise guidance, or all for the full checklist.",
2846
+ "inputSchema": {
2847
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
2848
+ "type": "object",
2849
+ "properties": {
2850
+ "topic": {
2851
+ "default": "all",
2852
+ "type": "string",
2853
+ "enum": [
2854
+ "all",
2855
+ "overview",
2856
+ "discovery",
2857
+ "layer2",
2858
+ "policy",
2859
+ "migration",
2860
+ "verification"
2861
+ ]
2862
+ }
2863
+ },
2864
+ "required": ["topic"],
2865
+ "additionalProperties": false
2866
+ }
2867
+ },
2280
2868
  {
2281
2869
  "name": "design_network_segment",
2282
- "title": "Design Isolated VLAN Segment",
2870
+ "title": "Preview or Build Partial IPv4 VLAN Scaffolding",
2283
2871
  "risk": "dangerous",
2284
2872
  "annotations": {
2285
2873
  "destructiveHint": true,
2286
2874
  "openWorldHint": false
2287
2875
  },
2288
- "description": "Stands up a complete isolated network segment in one call: a VLAN interface on the bridge, its gateway IP, a DHCP server + pool + network, optional internet access (srcnat masquerade), and inter-VLAN isolation firewall rules — e.g. 'a guest VLAN that reaches the internet but not the LAN'. DEFAULTS TO A DRY RUN (`apply=false`) showing every command grouped; set `apply=true` to build it. Bridge VLAN tagging is added when `tagged_ports`/`untagged_ports` are given (requires bridge vlan-filtering). Isolation drops forward traffic from this subnet to each `isolate_from` subnet. Returns the plan or a build report.",
2876
+ "description": "Preview partial IPv4 VLAN interface/gateway/DHCP scaffolding (apply=false, no router I/O). Read get_vlan_segmentation_guide first. Does NOT produce a complete isolated network. Optional NAT requires explicit wan_interface; isolation drops require a reviewed isolation_before .id. Bridge membership includes the CPU when ports are supplied, but port PVID/admission, filtering, Wi-Fi, INPUT and IPv6 policies remain separate work. apply=true runs sequential non-idempotent writes only after explicit approval, backup and a protected management/Safe Mode plan; failures may leave partial state. Read back and test clients; never retry blindly or claim isolation from command success.",
2289
2877
  "inputSchema": {
2290
2878
  "$schema": "https://json-schema.org/draft/2020-12/schema",
2291
2879
  "type": "object",
@@ -2302,11 +2890,15 @@
2302
2890
  },
2303
2891
  "subnet": {
2304
2892
  "type": "string",
2305
- "description": "CIDR for the segment, e.g. '192.168.30.0/24'"
2893
+ "format": "cidrv4",
2894
+ "pattern": "^((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\\.){3}(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\\/([0-9]|[1-2][0-9]|3[0-2])$",
2895
+ "description": "Canonical IPv4 network CIDR, e.g. '192.168.30.0/24'"
2306
2896
  },
2307
2897
  "gateway": {
2308
2898
  "type": "string",
2309
- "description": "Router's address in the segment, e.g. '192.168.30.1'"
2899
+ "format": "ipv4",
2900
+ "pattern": "^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$",
2901
+ "description": "Usable router address inside the subnet, excluded from the DHCP pool"
2310
2902
  },
2311
2903
  "bridge": {
2312
2904
  "default": "bridge",
@@ -2314,7 +2906,7 @@
2314
2906
  "type": "string"
2315
2907
  },
2316
2908
  "tagged_ports": {
2317
- "description": "Comma-separated trunk/tagged ports (+ the bridge)",
2909
+ "description": "Comma-separated verified tagged ports; the bridge/CPU is included once automatically",
2318
2910
  "type": "string"
2319
2911
  },
2320
2912
  "untagged_ports": {
@@ -2327,21 +2919,33 @@
2327
2919
  "type": "boolean"
2328
2920
  },
2329
2921
  "dhcp_range": {
2330
- "description": "Pool range; defaults to .10–.254 of the subnet",
2922
+ "description": "Single start-end IPv4 range excluding gateway/network/broadcast. Required outside /24; /24 defaults to .10–.254",
2331
2923
  "type": "string"
2332
2924
  },
2333
2925
  "internet": {
2334
2926
  "default": true,
2335
- "description": "Allow internet access via srcnat masquerade",
2927
+ "description": "Add egress-scoped IPv4 masquerade (requires wan_interface); not a firewall allow. Set false to reuse existing NAT",
2336
2928
  "type": "boolean"
2337
2929
  },
2930
+ "wan_interface": {
2931
+ "description": "Verified egress interface for new masquerade. Required when internet=true; never inferred",
2932
+ "type": "string",
2933
+ "minLength": 1
2934
+ },
2338
2935
  "isolate_from": {
2339
2936
  "description": "Subnets this segment must NOT reach, e.g. ['192.168.1.0/24']",
2340
2937
  "type": "array",
2341
2938
  "items": {
2342
- "type": "string"
2939
+ "type": "string",
2940
+ "format": "cidrv4",
2941
+ "pattern": "^((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\\.){3}(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\\/([0-9]|[1-2][0-9]|3[0-2])$"
2343
2942
  }
2344
2943
  },
2944
+ "isolation_before": {
2945
+ "description": "Current enabled forward rule .id from a fresh read; insert drops before this reviewed rule, not after broad accepts. Required with isolate_from",
2946
+ "type": "string",
2947
+ "pattern": "^\\*[0-9a-f]+$"
2948
+ },
2345
2949
  "apply": {
2346
2950
  "default": false,
2347
2951
  "description": "false = preview (default); true = build",
@@ -2360,7 +2964,7 @@
2360
2964
  "destructiveHint": false,
2361
2965
  "openWorldHint": false
2362
2966
  },
2363
- "description": "Creates a bridge interface (`/interface bridge`) — combines multiple interfaces into a Layer-2 switch domain. Set `vlan_filtering=true` to enable 802.1Q VLAN awareness; set `protocol_mode` for STP/RSTP/MSTP spanning-tree. For adding a member interface to an existing bridge use `add_bridge_port`; for standalone 802.1Q VLAN sub-interfaces use `create_vlan_interface`. Returns the created bridge's full detail including its `.id`.",
2967
+ "description": "Creates a bridge interface (`/interface bridge`) — combines multiple interfaces into a Layer-2 switch domain. For VLAN migration read get_vlan_segmentation_guide first. Stage a new bridge with filtering off; enable it LAST after VLAN membership and protected management access are ready. Set `protocol_mode` for STP/RSTP/MSTP spanning-tree. For adding a member interface to an existing bridge use `add_bridge_port`; for standalone 802.1Q VLAN sub-interfaces use `create_vlan_interface`. Returns the created bridge's full detail including its `.id`.",
2364
2968
  "inputSchema": {
2365
2969
  "$schema": "https://json-schema.org/draft/2020-12/schema",
2366
2970
  "type": "object",
@@ -2529,7 +3133,7 @@
2529
3133
  "idempotentHint": true,
2530
3134
  "openWorldHint": false
2531
3135
  },
2532
- "description": "Modifies settings on an existing bridge interface (`/interface bridge set`). Use to rename a bridge (`new_name`), toggle VLAN filtering, change STP/RSTP/MSTP protocol mode, adjust MTU, or enable/disable the bridge. For adding or removing member interfaces use `add_bridge_port` / `remove_bridge_port`; for VLAN table entries use `add_bridge_vlan`. Identified by the current bridge `name`; supply only the fields you want to change.",
3136
+ "description": "Modifies settings on an existing bridge interface (`/interface bridge set`). Use to rename a bridge (`new_name`), toggle VLAN filtering, change STP/RSTP/MSTP protocol mode, adjust MTU, or enable/disable the bridge. VLAN filtering can interrupt management: read get_vlan_segmentation_guide, verify CPU membership, PVID/admission and recovery access before enabling it LAST. Do not disable existing filtering to simplify migration. For adding or removing member interfaces use `add_bridge_port` / `remove_bridge_port`; for VLAN table entries use `add_bridge_vlan`. Identified by the current bridge `name`; supply only the fields you want to change.",
2533
3137
  "inputSchema": {
2534
3138
  "$schema": "https://json-schema.org/draft/2020-12/schema",
2535
3139
  "type": "object",
@@ -2884,7 +3488,7 @@
2884
3488
  "destructiveHint": false,
2885
3489
  "openWorldHint": false
2886
3490
  },
2887
- "description": "Adds a VLAN membership entry to a bridge's 802.1Q VLAN table (`/interface bridge vlan add`). Use to define which ports carry a specific VLAN as tagged (trunk) or untagged (access). Requires `vlan-filtering` to be enabled on the bridge (set via `create_bridge` or `update_bridge`). `vlan_ids` accepts a single ID (e.g. '100') or comma-separated list (e.g. '100,200'); `tagged` and `untagged` accept comma-separated interface names. For standalone 802.1Q VLAN sub-interfaces use `create_vlan_interface`; for listing existing VLAN table entries use `list_bridge_vlans`; for setting per-port native VLAN use the `pvid` parameter in `add_bridge_port`.",
3491
+ "description": "Adds a VLAN membership entry to a bridge's 802.1Q VLAN table (`/interface bridge vlan add`). Use to define which ports carry a specific VLAN as tagged (trunk) or untagged (access). Entries can be staged BEFORE enabling filtering; filtering enforces membership and should be enabled LAST after management is protected. For routed VLANs verify tagged bridge/CPU membership. Use one VLAN ID per entry containing access ports and align their PVID/admission; read get_vlan_segmentation_guide first. `vlan_ids` accepts a single ID (e.g. '100') or comma-separated list (e.g. '100,200'); `tagged` and `untagged` accept comma-separated interface names. For standalone 802.1Q VLAN sub-interfaces use `create_vlan_interface`; for listing existing VLAN table entries use `list_bridge_vlans`; for setting per-port native VLAN use the `pvid` parameter in `add_bridge_port`.",
2888
3492
  "inputSchema": {
2889
3493
  "$schema": "https://json-schema.org/draft/2020-12/schema",
2890
3494
  "type": "object",
@@ -21860,6 +22464,53 @@
21860
22464
  "additionalProperties": false
21861
22465
  }
21862
22466
  },
22467
+ {
22468
+ "name": "list_ovpn_sessions",
22469
+ "title": "List Active OpenVPN Connections",
22470
+ "risk": "read",
22471
+ "annotations": {
22472
+ "readOnlyHint": true,
22473
+ "idempotentHint": true,
22474
+ "openWorldHint": false
22475
+ },
22476
+ "description": "Read currently connected OpenVPN users on an explicit router, including assigned IP, caller address, uptime, encoding and RADIUS status. Reads only /ppp active where service=ovpn; does not read secrets, historical sessions, or outbound clients. Returns structured JSON and short-lived disconnect tokens for individual sessions. A cached read is at most two seconds old; errors are not an empty list.",
22477
+ "inputSchema": {
22478
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
22479
+ "type": "object",
22480
+ "properties": {},
22481
+ "additionalProperties": false
22482
+ }
22483
+ },
22484
+ {
22485
+ "name": "disconnect_ovpn_session",
22486
+ "title": "Disconnect One OpenVPN Connection",
22487
+ "risk": "destructive",
22488
+ "annotations": {
22489
+ "destructiveHint": true,
22490
+ "idempotentHint": true,
22491
+ "openWorldHint": false
22492
+ },
22493
+ "description": "Disconnect exactly one observed OpenVPN connection after explicit operator approval. First list_ovpn_sessions on the same explicit router, then supply its fresh disconnectToken. Rechecks internal ID, session ID, username, addresses and uptime before removal, then verifies absence. Does not disable or delete the account; clients can reconnect and PPP on-down hooks may run. Can interrupt your own management tunnel. Unknown outcomes must be reconciled by reading again, never automatically retried. Not available during Safe Mode.",
22494
+ "inputSchema": {
22495
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
22496
+ "type": "object",
22497
+ "properties": {
22498
+ "token": {
22499
+ "type": "string",
22500
+ "format": "uuid",
22501
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
22502
+ "description": "Fresh disconnectToken from list_ovpn_sessions on this router; expires after 60 seconds and is single-use."
22503
+ },
22504
+ "confirm": {
22505
+ "type": "boolean",
22506
+ "const": true,
22507
+ "description": "Explicit operator approval to terminate this one live connection. The client can reconnect."
22508
+ }
22509
+ },
22510
+ "required": ["token", "confirm"],
22511
+ "additionalProperties": false
22512
+ }
22513
+ },
21863
22514
  {
21864
22515
  "name": "get_ovpn_server",
21865
22516
  "title": "Get OpenVPN Server Configuration",
@@ -31214,6 +31865,38 @@
31214
31865
  "additionalProperties": false
31215
31866
  }
31216
31867
  },
31868
+ {
31869
+ "name": "get_routeros_container_guide",
31870
+ "title": "Get RouterOS Container Guide",
31871
+ "risk": "read",
31872
+ "annotations": {
31873
+ "readOnlyHint": true,
31874
+ "idempotentHint": true,
31875
+ "openWorldHint": false
31876
+ },
31877
+ "description": "Read shared version-aware container knowledge: prerequisites, image compatibility, VETH isolation, lifecycle, secrets and troubleshooting. No device access. Use before auditing, deploying or changing containers.",
31878
+ "inputSchema": {
31879
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
31880
+ "type": "object",
31881
+ "properties": {
31882
+ "topic": {
31883
+ "default": "all",
31884
+ "type": "string",
31885
+ "enum": [
31886
+ "all",
31887
+ "prerequisites",
31888
+ "images",
31889
+ "networking",
31890
+ "lifecycle",
31891
+ "security",
31892
+ "troubleshooting"
31893
+ ]
31894
+ }
31895
+ },
31896
+ "required": ["topic"],
31897
+ "additionalProperties": false
31898
+ }
31899
+ },
31217
31900
  {
31218
31901
  "name": "list_containers",
31219
31902
  "title": "List Containers",
@@ -31223,26 +31906,24 @@
31223
31906
  "idempotentHint": true,
31224
31907
  "openWorldHint": false
31225
31908
  },
31226
- "description": "List every OCI container on the device (`/container print`) with its status, image tag, name, VETH interface and root-dir — the starting point for any container work and the way to POLL the lifecycle, which is asynchronous: status moves extracting → stopped (ready to start) → running. Use this to find the `name`/`tag` the other tools take, to confirm an add has finished extracting before start_container, and to confirm a stop has completed before remove_container. Filter by partial `name_filter`, `tag_filter`, or `status_filter` (e.g. 'running', 'stopped'); set `detail=true` for the full property block. For one container use get_container. A container's stdout/stderr is in the system log (`/log print where topics~\"container\"`) when it was created with logging=yes.",
31909
+ "description": "Discover container .ids, exact names/tags and lifecycle status/flags. Pull/start/stop are asynchronous; running is not application health. Sensitive env/command/config fields are masked. Use get_routeros_container_guide before changes.",
31227
31910
  "inputSchema": {
31228
31911
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31229
31912
  "type": "object",
31230
31913
  "properties": {
31231
31914
  "name_filter": {
31232
- "description": "Partial container name match",
31915
+ "description": "RouterOS name regex, escaped as a command value",
31233
31916
  "type": "string"
31234
31917
  },
31235
31918
  "tag_filter": {
31236
- "description": "Partial image tag match",
31237
31919
  "type": "string"
31238
31920
  },
31239
31921
  "status_filter": {
31240
- "description": "e.g. 'running', 'stopped'",
31922
+ "description": "Legacy status regex; newer releases may expose flags instead",
31241
31923
  "type": "string"
31242
31924
  },
31243
31925
  "detail": {
31244
31926
  "default": false,
31245
- "description": "Show the full per-container property block",
31246
31927
  "type": "boolean"
31247
31928
  }
31248
31929
  },
@@ -31259,18 +31940,25 @@
31259
31940
  "idempotentHint": true,
31260
31941
  "openWorldHint": false
31261
31942
  },
31262
- "description": "Full detail for one container (`/container print detail`) — status, image tag, interface, root-dir, env/mounts, cmd/entrypoint, hostname/dns, logging and start-on-boot. Identify by `name` (preferred) or `tag`. Use list_containers to discover identifiers.",
31943
+ "description": "Read one exact, unique container by stable id, name or exact tag; rejects ambiguity. Sensitive env, command and image-config fields are masked. Missing state is unknown, not stopped.",
31263
31944
  "inputSchema": {
31264
31945
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31265
31946
  "type": "object",
31266
31947
  "properties": {
31948
+ "id": {
31949
+ "description": "Stable .id from fresh discovery; never a row number",
31950
+ "type": "string",
31951
+ "pattern": "^\\*[\\da-fA-F]+$"
31952
+ },
31267
31953
  "name": {
31268
- "description": "Container name (set via add_container)",
31269
- "type": "string"
31954
+ "description": "Exact unique container name",
31955
+ "type": "string",
31956
+ "minLength": 1
31270
31957
  },
31271
31958
  "tag": {
31272
- "description": "Image tag to match (e.g. 'pihole') if no name",
31273
- "type": "string"
31959
+ "description": "Exact unique image tag, not a regex; prefer id when images are shared",
31960
+ "type": "string",
31961
+ "minLength": 1
31274
31962
  }
31275
31963
  },
31276
31964
  "additionalProperties": false
@@ -31284,97 +31972,109 @@
31284
31972
  "destructiveHint": false,
31285
31973
  "openWorldHint": false
31286
31974
  },
31287
- "description": "Create an OCI container (`/container add`). PREREQUISITES, in order: (1) the `container` package installed + device-mode `container=yes`; (2) an external disk for storage (containers should never run on internal flash); (3) for `remote_image`, a registry URL + on-disk `tmpdir` set via set_container_config; (4) a VETH for networking — create it first with `/interface veth add name=veth1 address=172.17.0.2/24 gateway=172.17.0.1`, then bridge it and add a srcnat masquerade rule for internet (and a dst-nat to publish a port). Then create the container: supply EITHER `remote_image` (registry pull, e.g. 'library/alpine:latest') OR `file` (a local image tar on the device — must be a SINGLE-LAYER, UNCOMPRESSED Docker-v1 tar). Set `interface` to the VETH and `root_dir` to a path on the external disk (e.g. 'disk1/myapp'). Attach config via inline `env` ('K=v,K2=v2') / `mount` ('src=disk1/data,dst=/data'), or reference named lists with `envlists`/`mountlists` (add_container_env / add_container_mount). Override `cmd`/`entrypoint`/`workdir`; set `hostname`/`dns`; enable `logging`/`start_on_boot`; cap `memory_high`/`cpu_list`. ALWAYS set `name` so the lifecycle tools can find it. The image pull/extract is ASYNCHRONOUS: this returns immediately, then poll list_containers until status becomes 'stopped' (extraction done) before calling start_container.",
31975
+ "description": "Create one container after approved prerequisite, image/storage and network review. Requires exactly one image source, a unique name, VETH and dedicated root_dir. No package installation, device-mode, NAT or firewall changes are implicit. Use supported image-save archives; no blanket single-layer restriction. Explicit legacy envlist/mounts aliases are available; inspect target syntax before writing. Returns a pending extraction request, not a healthy deployment; poll before starting.",
31288
31976
  "inputSchema": {
31289
31977
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31290
31978
  "type": "object",
31291
31979
  "properties": {
31292
- "name": {
31293
- "description": "Container name (recommended for management)",
31294
- "type": "string"
31295
- },
31296
- "remote_image": {
31297
- "description": "Registry image, e.g. 'library/alpine:latest'",
31298
- "type": "string"
31299
- },
31300
- "file": {
31301
- "description": "Local Docker-v1 tar on the device (alternative to remote_image)",
31302
- "type": "string"
31303
- },
31304
31980
  "interface": {
31305
- "description": "VETH interface name",
31306
- "type": "string"
31981
+ "type": "string",
31982
+ "minLength": 1,
31983
+ "description": "Previously configured VETH"
31307
31984
  },
31308
31985
  "root_dir": {
31309
- "description": "Filesystem root, e.g. 'disk1/myapp'",
31310
- "type": "string"
31986
+ "type": "string",
31987
+ "minLength": 1,
31988
+ "description": "Dedicated root path on verified storage"
31311
31989
  },
31312
31990
  "env": {
31313
- "description": "Inline env vars: 'K=v,K2=v2' (7.21+)",
31991
+ "description": "Sensitive inline environment; verify support on the target",
31314
31992
  "type": "string"
31315
31993
  },
31316
31994
  "envlists": {
31317
- "description": "Named env list name(s) (add_container_env)",
31995
+ "description": "Current CLI named environment lists",
31996
+ "type": "string"
31997
+ },
31998
+ "envlist": {
31999
+ "description": "Legacy singular envlist; exclusive with envlists",
31318
32000
  "type": "string"
31319
32001
  },
31320
32002
  "mount": {
31321
- "description": "Inline mount: 'src=disk1/data,dst=/data' (7.21+)",
32003
+ "description": "Inline mount expression supported by the target; not Docker syntax",
31322
32004
  "type": "string"
31323
32005
  },
31324
32006
  "mountlists": {
31325
- "description": "Named mount name(s) (add_container_mount)",
32007
+ "description": "Current CLI named mount lists",
32008
+ "type": "string"
32009
+ },
32010
+ "mounts": {
32011
+ "description": "Legacy mounts reference; exclusive with mountlists",
31326
32012
  "type": "string"
31327
32013
  },
31328
32014
  "cmd": {
31329
- "description": "Override container CMD",
32015
+ "description": "Command override; may contain secrets",
31330
32016
  "type": "string"
31331
32017
  },
31332
32018
  "entrypoint": {
31333
- "description": "Override container ENTRYPOINT",
32019
+ "description": "Entrypoint override; may contain secrets",
31334
32020
  "type": "string"
31335
32021
  },
31336
32022
  "workdir": {
31337
- "description": "Override working directory",
31338
32023
  "type": "string"
31339
32024
  },
31340
32025
  "hostname": {
31341
32026
  "type": "string"
31342
32027
  },
31343
32028
  "dns": {
31344
- "description": "DNS server for the container",
31345
32029
  "type": "string"
31346
32030
  },
31347
32031
  "user": {
31348
32032
  "type": "string"
31349
32033
  },
31350
32034
  "stop_signal": {
31351
- "description": "Signal used to stop the container",
31352
32035
  "type": "string"
31353
32036
  },
31354
32037
  "devices": {
31355
- "description": "Pass-through physical devices (7.20+)",
32038
+ "description": "Device passthrough; extra privilege requires explicit review",
31356
32039
  "type": "string"
31357
32040
  },
31358
32041
  "cpu_list": {
31359
- "description": "CPU core affinity",
31360
32042
  "type": "string"
31361
32043
  },
31362
32044
  "memory_high": {
31363
- "description": "RAM limit, e.g. '256M'",
32045
+ "description": "Soft memory pressure threshold, not a hard cap",
32046
+ "type": "string"
32047
+ },
32048
+ "memory_max": {
32049
+ "description": "Hard memory limit only where supported; can terminate processes",
31364
32050
  "type": "string"
31365
32051
  },
31366
32052
  "logging": {
31367
- "description": "Send stdout/stderr to the RouterOS log",
31368
32053
  "type": "boolean"
31369
32054
  },
31370
32055
  "start_on_boot": {
31371
- "description": "Auto-start on device boot",
31372
32056
  "type": "boolean"
31373
32057
  },
31374
32058
  "comment": {
31375
32059
  "type": "string"
32060
+ },
32061
+ "name": {
32062
+ "type": "string",
32063
+ "minLength": 1,
32064
+ "description": "Unique name for read-back and ambiguous-write recovery"
32065
+ },
32066
+ "remote_image": {
32067
+ "description": "Reviewed architecture-compatible image with pinned version/digest",
32068
+ "type": "string",
32069
+ "minLength": 1
32070
+ },
32071
+ "file": {
32072
+ "description": "Uploaded Docker/Podman saved image archive supported by the target",
32073
+ "type": "string",
32074
+ "minLength": 1
31376
32075
  }
31377
32076
  },
32077
+ "required": ["interface", "root_dir", "name"],
31378
32078
  "additionalProperties": false
31379
32079
  }
31380
32080
  },
@@ -31387,41 +32087,66 @@
31387
32087
  "idempotentHint": true,
31388
32088
  "openWorldHint": false
31389
32089
  },
31390
- "description": "Modify an existing container's properties in place (`/container set [find …]`) without recreating it — change `start_on_boot`, `logging`, `cmd`/`entrypoint`/`workdir`, `hostname`/`dns`, `interface`, `root_dir`, inline `env`/`mount` or `envlists`/`mountlists`, resource caps, or `comment`. Identify by `name` or `tag`. Best practice: stop the container first (stop_container) before changing runtime properties like interface, env, mounts or cmd — they take effect on the next start_container, not live. To create a new container use add_container; to change the image, remove and re-add.",
32090
+ "description": "Update exactly one container. Runtime settings require positive fully-stopped evidence; logging, comment and start_on_boot can change without stopping. Named env/mount lists can affect other consumers. Inspect target syntax; no automatic compatibility retries.",
31391
32091
  "inputSchema": {
31392
32092
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31393
32093
  "type": "object",
31394
32094
  "properties": {
32095
+ "id": {
32096
+ "description": "Stable .id from fresh discovery; never a row number",
32097
+ "type": "string",
32098
+ "pattern": "^\\*[\\da-fA-F]+$"
32099
+ },
31395
32100
  "name": {
31396
- "description": "Container name (set via add_container)",
31397
- "type": "string"
32101
+ "description": "Exact unique container name",
32102
+ "type": "string",
32103
+ "minLength": 1
31398
32104
  },
31399
32105
  "tag": {
31400
- "description": "Image tag to match (e.g. 'pihole') if no name",
31401
- "type": "string"
32106
+ "description": "Exact unique image tag, not a regex; prefer id when images are shared",
32107
+ "type": "string",
32108
+ "minLength": 1
31402
32109
  },
31403
32110
  "interface": {
31404
- "type": "string"
32111
+ "description": "VETH interface(s); verify target syntax and image interface names",
32112
+ "type": "string",
32113
+ "minLength": 1
31405
32114
  },
31406
32115
  "root_dir": {
31407
- "type": "string"
32116
+ "description": "Dedicated root path on appropriate storage, not internal flash",
32117
+ "type": "string",
32118
+ "minLength": 1
31408
32119
  },
31409
32120
  "env": {
32121
+ "description": "Sensitive inline environment; verify support on the target",
31410
32122
  "type": "string"
31411
32123
  },
31412
32124
  "envlists": {
32125
+ "description": "Current CLI named environment lists",
32126
+ "type": "string"
32127
+ },
32128
+ "envlist": {
32129
+ "description": "Legacy singular envlist; exclusive with envlists",
31413
32130
  "type": "string"
31414
32131
  },
31415
32132
  "mount": {
32133
+ "description": "Inline mount expression supported by the target; not Docker syntax",
31416
32134
  "type": "string"
31417
32135
  },
31418
32136
  "mountlists": {
32137
+ "description": "Current CLI named mount lists",
32138
+ "type": "string"
32139
+ },
32140
+ "mounts": {
32141
+ "description": "Legacy mounts reference; exclusive with mountlists",
31419
32142
  "type": "string"
31420
32143
  },
31421
32144
  "cmd": {
32145
+ "description": "Command override; may contain secrets",
31422
32146
  "type": "string"
31423
32147
  },
31424
32148
  "entrypoint": {
32149
+ "description": "Entrypoint override; may contain secrets",
31425
32150
  "type": "string"
31426
32151
  },
31427
32152
  "workdir": {
@@ -31433,10 +32158,25 @@
31433
32158
  "dns": {
31434
32159
  "type": "string"
31435
32160
  },
32161
+ "user": {
32162
+ "type": "string"
32163
+ },
32164
+ "stop_signal": {
32165
+ "type": "string"
32166
+ },
32167
+ "devices": {
32168
+ "description": "Device passthrough; extra privilege requires explicit review",
32169
+ "type": "string"
32170
+ },
31436
32171
  "cpu_list": {
31437
32172
  "type": "string"
31438
32173
  },
31439
32174
  "memory_high": {
32175
+ "description": "Soft memory pressure threshold, not a hard cap",
32176
+ "type": "string"
32177
+ },
32178
+ "memory_max": {
32179
+ "description": "Hard memory limit only where supported; can terminate processes",
31440
32180
  "type": "string"
31441
32181
  },
31442
32182
  "logging": {
@@ -31460,18 +32200,25 @@
31460
32200
  "destructiveHint": false,
31461
32201
  "openWorldHint": false
31462
32202
  },
31463
- "description": "Start a stopped container (`/container start [find …]`). Identify by `name` or `tag`. The container must have finished extracting (status 'stopped') first — check with list_containers. View its output in the log when logging=yes. To stop it use stop_container.",
32203
+ "description": "start exactly one container by stable id, exact unique name or tag. Start requires positive stopped evidence. Asynchronous: inspect state with bounded polling; accepted does not mean healthy/completed.",
31464
32204
  "inputSchema": {
31465
32205
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31466
32206
  "type": "object",
31467
32207
  "properties": {
32208
+ "id": {
32209
+ "description": "Stable .id from fresh discovery; never a row number",
32210
+ "type": "string",
32211
+ "pattern": "^\\*[\\da-fA-F]+$"
32212
+ },
31468
32213
  "name": {
31469
- "description": "Container name (set via add_container)",
31470
- "type": "string"
32214
+ "description": "Exact unique container name",
32215
+ "type": "string",
32216
+ "minLength": 1
31471
32217
  },
31472
32218
  "tag": {
31473
- "description": "Image tag to match (e.g. 'pihole') if no name",
31474
- "type": "string"
32219
+ "description": "Exact unique image tag, not a regex; prefer id when images are shared",
32220
+ "type": "string",
32221
+ "minLength": 1
31475
32222
  }
31476
32223
  },
31477
32224
  "additionalProperties": false
@@ -31485,18 +32232,25 @@
31485
32232
  "destructiveHint": false,
31486
32233
  "openWorldHint": false
31487
32234
  },
31488
- "description": "Stop a running container (`/container stop [find …]`). Identify by `name` or `tag`. Stopping is asynchronous — poll list_containers until status is 'stopped' before removing it. To start it again use start_container.",
32235
+ "description": "stop exactly one container by stable id, exact unique name or tag. Start requires positive stopped evidence. Asynchronous: inspect state with bounded polling; accepted does not mean healthy/completed.",
31489
32236
  "inputSchema": {
31490
32237
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31491
32238
  "type": "object",
31492
32239
  "properties": {
32240
+ "id": {
32241
+ "description": "Stable .id from fresh discovery; never a row number",
32242
+ "type": "string",
32243
+ "pattern": "^\\*[\\da-fA-F]+$"
32244
+ },
31493
32245
  "name": {
31494
- "description": "Container name (set via add_container)",
31495
- "type": "string"
32246
+ "description": "Exact unique container name",
32247
+ "type": "string",
32248
+ "minLength": 1
31496
32249
  },
31497
32250
  "tag": {
31498
- "description": "Image tag to match (e.g. 'pihole') if no name",
31499
- "type": "string"
32251
+ "description": "Exact unique image tag, not a regex; prefer id when images are shared",
32252
+ "type": "string",
32253
+ "minLength": 1
31500
32254
  }
31501
32255
  },
31502
32256
  "additionalProperties": false
@@ -31511,18 +32265,25 @@
31511
32265
  "idempotentHint": true,
31512
32266
  "openWorldHint": false
31513
32267
  },
31514
- "description": "Permanently delete a container (`/container remove [find …]`). The container must be FULLY STOPPED first — RouterOS rejects removal while it is running or still stopping. If removal fails for that reason, stop it (stop_container), wait until list_containers shows status 'stopped', then retry. Identify by `name` or `tag`. This does not delete its root-dir data on disk.",
32268
+ "description": "Remove exactly one container after a positive stopped check. Back up application data first; do not assume root-dir survives removal. Does not separately delete volumes/layers. Verify absence; never blindly retry an ambiguous write.",
31515
32269
  "inputSchema": {
31516
32270
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31517
32271
  "type": "object",
31518
32272
  "properties": {
32273
+ "id": {
32274
+ "description": "Stable .id from fresh discovery; never a row number",
32275
+ "type": "string",
32276
+ "pattern": "^\\*[\\da-fA-F]+$"
32277
+ },
31519
32278
  "name": {
31520
- "description": "Container name (set via add_container)",
31521
- "type": "string"
32279
+ "description": "Exact unique container name",
32280
+ "type": "string",
32281
+ "minLength": 1
31522
32282
  },
31523
32283
  "tag": {
31524
- "description": "Image tag to match (e.g. 'pihole') if no name",
31525
- "type": "string"
32284
+ "description": "Exact unique image tag, not a regex; prefer id when images are shared",
32285
+ "type": "string",
32286
+ "minLength": 1
31526
32287
  }
31527
32288
  },
31528
32289
  "additionalProperties": false
@@ -31537,7 +32298,7 @@
31537
32298
  "idempotentHint": true,
31538
32299
  "openWorldHint": false
31539
32300
  },
31540
- "description": "Read the global container configuration (`/container config print`) — the image registry URL, the tmpdir used for pulls/extraction, the layer directory, and the RAM-high limit. Use to verify the registry/tmpdir are set before pulling images. To change them use set_container_config.",
32301
+ "description": "Read registry, extraction storage and memory settings. Registry credentials are masked. Settings are router-wide and may affect every container.",
31541
32302
  "inputSchema": {
31542
32303
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31543
32304
  "type": "object",
@@ -31554,33 +32315,31 @@
31554
32315
  "idempotentHint": true,
31555
32316
  "openWorldHint": false
31556
32317
  },
31557
- "description": "Configure the global container settings (`/container config set`) — the router-wide singleton that MUST be set before pulling any `remote_image` with add_container. Set `registry_url` (Docker Hub is 'https://registry-1.docker.io') and `tmpdir` to a path on an EXTERNAL disk (e.g. 'disk1/pull') — pulls and extraction need real space and IOPS, never internal flash. Optionally set `layer_dir`, a `ram_high` cap, and `username`/`password` for a private registry (credentials are redacted from output). The router also needs working DNS + internet to reach the registry. To read the current values use get_container_config.",
32318
+ "description": "Update router-wide registry/extraction/storage/memory settings and read back. Use verified storage and HTTPS registry; may affect other workloads. memory_high is a soft threshold. ram_high is a compatibility input alias for the same RouterOS memory-high property.",
31558
32319
  "inputSchema": {
31559
32320
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31560
32321
  "type": "object",
31561
32322
  "properties": {
31562
32323
  "registry_url": {
31563
- "description": "Image registry URL",
31564
32324
  "type": "string"
31565
32325
  },
31566
32326
  "tmpdir": {
31567
- "description": "Pull/extract temp dir, e.g. 'disk1/pull'",
31568
32327
  "type": "string"
31569
32328
  },
31570
32329
  "layer_dir": {
31571
- "description": "Directory for extracted image layers",
32330
+ "type": "string"
32331
+ },
32332
+ "memory_high": {
31572
32333
  "type": "string"
31573
32334
  },
31574
32335
  "ram_high": {
31575
- "description": "RAM-high limit, e.g. '256M'",
32336
+ "description": "Deprecated alias of memory_high; never sent as ram-high",
31576
32337
  "type": "string"
31577
32338
  },
31578
32339
  "username": {
31579
- "description": "Registry username (private registries)",
31580
32340
  "type": "string"
31581
32341
  },
31582
32342
  "password": {
31583
- "description": "Registry password (private registries)",
31584
32343
  "type": "string"
31585
32344
  }
31586
32345
  },
@@ -31589,20 +32348,20 @@
31589
32348
  },
31590
32349
  {
31591
32350
  "name": "list_container_envs",
31592
- "title": "List Container Env Variables",
32351
+ "title": "List Container Env Metadata",
31593
32352
  "risk": "read",
31594
32353
  "annotations": {
31595
32354
  "readOnlyHint": true,
31596
32355
  "idempotentHint": true,
31597
32356
  "openWorldHint": false
31598
32357
  },
31599
- "description": "List named environment-variable entries (`/container envs print`) — each has a `list` (the group name referenced by a container's envlists), a `key` and a `value`. Optionally filter by partial `list_filter`. To add one use add_container_env; to delete use remove_container_env.",
32358
+ "description": "List environment .ids, list names and keys WITHOUT retrieving values. Treat every value as potentially secret. Shared lists may have multiple container consumers.",
31600
32359
  "inputSchema": {
31601
32360
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31602
32361
  "type": "object",
31603
32362
  "properties": {
31604
32363
  "list_filter": {
31605
- "description": "Partial env-list (group) name match",
32364
+ "description": "Exact list name",
31606
32365
  "type": "string"
31607
32366
  }
31608
32367
  },
@@ -31617,22 +32376,21 @@
31617
32376
  "destructiveHint": false,
31618
32377
  "openWorldHint": false
31619
32378
  },
31620
- "description": "Add an environment variable to a named list (`/container envs add list= key= value=`). Group related variables under the same `list` name, then point a container at the group with `envlists=<list>` (add_container or update_container) — a container that is already running must be restarted to pick up env changes. Named lists are reusable across containers; for a one-off, self-contained setup the inline `env` on add_container is simpler. The grouping `list=` property requires RouterOS 7.20+. Values may be secrets and are redacted from output.",
32379
+ "description": "Add a sensitive value to a named env list. Current CLI groups by list; check target syntax. Review all consumers before changing a shared list. Existing running containers may need an approved stop/start; no implicit restart.",
31621
32380
  "inputSchema": {
31622
32381
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31623
32382
  "type": "object",
31624
32383
  "properties": {
31625
32384
  "list": {
31626
32385
  "type": "string",
31627
- "description": "Env-list (group) name, e.g. 'MYAPP'"
32386
+ "minLength": 1
31628
32387
  },
31629
32388
  "key": {
31630
32389
  "type": "string",
31631
- "description": "Variable name, e.g. 'TZ'"
32390
+ "minLength": 1
31632
32391
  },
31633
32392
  "value": {
31634
- "type": "string",
31635
- "description": "Variable value"
32393
+ "type": "string"
31636
32394
  }
31637
32395
  },
31638
32396
  "required": ["list", "key", "value"],
@@ -31648,21 +32406,25 @@
31648
32406
  "idempotentHint": true,
31649
32407
  "openWorldHint": false
31650
32408
  },
31651
- "description": "Delete an environment variable from a list (`/container envs remove [find list= key=]`). Supply the `list` (group) name and the `key`. Verifies it exists first. To browse entries use list_container_envs.",
32409
+ "description": "Remove one env entry by stable id OR exact list+key. Reject duplicates/unreadable selection. Review containers consuming this list first; no implicit restart.",
31652
32410
  "inputSchema": {
31653
32411
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31654
32412
  "type": "object",
31655
32413
  "properties": {
32414
+ "id": {
32415
+ "description": "Stable .id from fresh discovery; never a row number",
32416
+ "type": "string",
32417
+ "pattern": "^\\*[\\da-fA-F]+$"
32418
+ },
31656
32419
  "list": {
31657
32420
  "type": "string",
31658
- "description": "Env-list (group) name"
32421
+ "minLength": 1
31659
32422
  },
31660
32423
  "key": {
31661
32424
  "type": "string",
31662
- "description": "Variable name to remove"
32425
+ "minLength": 1
31663
32426
  }
31664
32427
  },
31665
- "required": ["list", "key"],
31666
32428
  "additionalProperties": false
31667
32429
  }
31668
32430
  },
@@ -31675,14 +32437,19 @@
31675
32437
  "idempotentHint": true,
31676
32438
  "openWorldHint": false
31677
32439
  },
31678
- "description": "List named volume mounts (`/container mounts print`) — each has a `name` (referenced by a container's mountlists), a host source `src` (e.g. 'disk1/appdata') and a container destination `dst` (e.g. '/data'). Optionally filter by partial `name_filter`. To add one use add_container_mount; to delete use remove_container_mount.",
32440
+ "description": "Read mount metadata. Current CLI groups by list; legacy CLI may use name. No application files are read. A list can contain several mounts.",
31679
32441
  "inputSchema": {
31680
32442
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31681
32443
  "type": "object",
31682
32444
  "properties": {
32445
+ "list_filter": {
32446
+ "type": "string",
32447
+ "minLength": 1
32448
+ },
31683
32449
  "name_filter": {
31684
- "description": "Partial mount name match",
31685
- "type": "string"
32450
+ "description": "Legacy exact name filter",
32451
+ "type": "string",
32452
+ "minLength": 1
31686
32453
  }
31687
32454
  },
31688
32455
  "additionalProperties": false
@@ -31696,25 +32463,31 @@
31696
32463
  "destructiveHint": false,
31697
32464
  "openWorldHint": false
31698
32465
  },
31699
- "description": "Create a named volume mount (`/container mounts add name= src= dst=`) — persists container data on the host so it survives restarts/recreation. Maps a host source `src` (put it on an EXTERNAL disk, e.g. 'disk1/appdata', never internal flash) to a path `dst` inside the container (e.g. '/data'). Point a container at it with `mountlists=<name>` (add_container or update_container); a running container must be restarted to apply mount changes. For a one-off, the inline `mount` on add_container is simpler. Named mounts and `mountlists` require RouterOS 7.21+.",
32466
+ "description": "Add a persistent mount using current list= OR legacy name=, never both. Verify target syntax first. Use appropriate storage; a missing source may be populated from the image. Review consumers; this neither formats storage nor restarts containers.",
31700
32467
  "inputSchema": {
31701
32468
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31702
32469
  "type": "object",
31703
32470
  "properties": {
32471
+ "list": {
32472
+ "description": "Current CLI mount-list name",
32473
+ "type": "string",
32474
+ "minLength": 1
32475
+ },
31704
32476
  "name": {
32477
+ "description": "Legacy CLI mount name; do not use for current list syntax",
31705
32478
  "type": "string",
31706
- "description": "Mount name, e.g. 'appdata'"
32479
+ "minLength": 1
31707
32480
  },
31708
32481
  "src": {
31709
32482
  "type": "string",
31710
- "description": "Host source path, e.g. 'disk1/appdata'"
32483
+ "minLength": 1
31711
32484
  },
31712
32485
  "dst": {
31713
32486
  "type": "string",
31714
- "description": "Container destination path, e.g. '/data'"
32487
+ "minLength": 1
31715
32488
  }
31716
32489
  },
31717
- "required": ["name", "src", "dst"],
32490
+ "required": ["src", "dst"],
31718
32491
  "additionalProperties": false
31719
32492
  }
31720
32493
  },
@@ -31727,17 +32500,33 @@
31727
32500
  "idempotentHint": true,
31728
32501
  "openWorldHint": false
31729
32502
  },
31730
- "description": "Delete a named volume mount (`/container mounts remove [find name=...]`). Verifies it exists first. Does not delete the host data at `src`. To browse mounts use list_container_mounts.",
32503
+ "description": "Remove one mount definition by stable id or unique list/name, optionally narrowed by src/dst. Rejects multi-entry lists. Review shared consumers first; no host files are deleted by this tool.",
31731
32504
  "inputSchema": {
31732
32505
  "$schema": "https://json-schema.org/draft/2020-12/schema",
31733
32506
  "type": "object",
31734
32507
  "properties": {
32508
+ "id": {
32509
+ "description": "Stable .id from fresh discovery; never a row number",
32510
+ "type": "string",
32511
+ "pattern": "^\\*[\\da-fA-F]+$"
32512
+ },
32513
+ "list": {
32514
+ "type": "string",
32515
+ "minLength": 1
32516
+ },
31735
32517
  "name": {
31736
32518
  "type": "string",
31737
- "description": "Mount name to remove"
32519
+ "minLength": 1
32520
+ },
32521
+ "src": {
32522
+ "type": "string",
32523
+ "minLength": 1
32524
+ },
32525
+ "dst": {
32526
+ "type": "string",
32527
+ "minLength": 1
31738
32528
  }
31739
32529
  },
31740
- "required": ["name"],
31741
32530
  "additionalProperties": false
31742
32531
  }
31743
32532
  },