@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.
- package/README.md +180 -8
- package/dist/cli.js +3452 -729
- package/dist/index.js +148 -27
- package/dist/shared/{library-ppnv0f07.js → library-588vnctn.js} +1 -1
- package/dist/shared/{library-7wcv2ckk.js → library-6tvh3gq1.js} +2837 -545
- package/dist/shared/{library-tqrvrykj.js → library-g8far2nz.js} +1 -1
- package/dist/shared/{library-f3be6g03.js → library-k6m2bxjr.js} +1 -1
- package/dist/shared/{library-z7qsdq88.js → library-wj2xfx8h.js} +1 -1
- package/dist/ui/aaa.html +8 -8
- package/dist/ui/connected-devices.html +8 -8
- package/dist/ui/dashboard.html +16 -16
- package/dist/ui/fabric.html +11 -11
- package/dist/ui/firewall-audit.html +8 -8
- package/dist/ui/firewall.html +9 -9
- package/dist/ui/interfaces.html +8 -8
- package/dist/ui/investigations.html +11 -11
- package/dist/ui/observability.html +66 -62
- package/dist/ui/operations.html +11 -11
- package/dist/ui/records.html +12 -12
- package/dist/ui/reports.html +11 -11
- package/dist/ui/round-trip.html +11 -11
- package/dist/ui/service-health.html +11 -11
- package/package.json +24 -23
- package/prompts/audit-routeros-containers.md +27 -0
- package/prompts/audit-vlan-segmentation.md +31 -0
- package/prompts/setup-guest-wifi.md +23 -24
- package/prompts/setup-routeros-container.md +36 -0
- package/prompts/setup-v2ray-container-proxy.md +68 -194
- package/prompts/setup-vlan-network.md +27 -33
- package/schemas/README.md +1 -1
- package/schemas/devtools-manifest.json +327 -16
- package/schemas/tool-catalog.json +898 -109
- package/schemas/tools/add_container.json +42 -30
- package/schemas/tools/add_container_env.json +3 -4
- package/schemas/tools/add_container_mount.json +10 -4
- package/schemas/tools/apply_service_routing.json +23 -0
- package/schemas/tools/arm_service_routing.json +23 -0
- package/schemas/tools/configure_flight_recorder.json +30 -0
- package/schemas/tools/create_service_routing.json +91 -0
- package/schemas/tools/design_network_segment.json +22 -6
- package/schemas/tools/destroy_recovery_lab.json +18 -0
- package/schemas/tools/disconnect_ovpn_session.json +20 -0
- package/schemas/tools/export_network_incident.json +14 -0
- package/schemas/tools/freeze_network_incident.json +14 -0
- package/schemas/tools/get_container.json +11 -4
- package/schemas/tools/get_flight_recorder.json +7 -0
- package/schemas/tools/get_recovery_lab.json +7 -0
- package/schemas/tools/get_routeros_container_guide.json +22 -0
- package/schemas/tools/get_vlan_segmentation_guide.json +14 -0
- package/schemas/tools/list_container_envs.json +1 -1
- package/schemas/tools/list_container_mounts.json +7 -2
- package/schemas/tools/list_containers.json +2 -4
- package/schemas/tools/list_ovpn_sessions.json +7 -0
- package/schemas/tools/list_service_routing.json +7 -0
- package/schemas/tools/poll_recovery_lab.json +14 -0
- package/schemas/tools/prepare_recovery_lab.json +23 -0
- package/schemas/tools/preview_service_routing.json +23 -0
- package/schemas/tools/probe_service_routing.json +14 -0
- package/schemas/tools/recovery_lab_inventory.json +7 -0
- package/schemas/tools/remove_container.json +11 -4
- package/schemas/tools/remove_container_env.json +7 -3
- package/schemas/tools/remove_container_mount.json +18 -2
- package/schemas/tools/service_routing_address_page.json +19 -0
- package/schemas/tools/service_routing_inventory.json +7 -0
- package/schemas/tools/service_routing_traffic.json +14 -0
- package/schemas/tools/set_container_config.json +4 -6
- package/schemas/tools/start_container.json +11 -4
- package/schemas/tools/start_recovery_lab.json +18 -0
- package/schemas/tools/stop_container.json +11 -4
- package/schemas/tools/update_container.json +46 -6
- /package/dist/shared/{cli-j07tbrke.js → cli-h065ap70.js} +0 -0
- /package/dist/shared/{cli-s0rxncz4.js → cli-se3tgt7t.js} +0 -0
- /package/dist/shared/{cli-y00nwzxx.js → cli-t311px0m.js} +0 -0
- /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.
|
|
3
|
+
"version": "5.21.0",
|
|
4
4
|
"generated": "by scripts/gen-schemas.ts — do not edit by hand",
|
|
5
|
-
"toolCount":
|
|
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
|
|
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.
|
|
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": "
|
|
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": "
|
|
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
|
-
"
|
|
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
|
-
"
|
|
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
|
|
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": "
|
|
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": "
|
|
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.
|
|
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).
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
31269
|
-
"type": "string"
|
|
31954
|
+
"description": "Exact unique container name",
|
|
31955
|
+
"type": "string",
|
|
31956
|
+
"minLength": 1
|
|
31270
31957
|
},
|
|
31271
31958
|
"tag": {
|
|
31272
|
-
"description": "
|
|
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
|
|
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
|
-
"
|
|
31306
|
-
"
|
|
31981
|
+
"type": "string",
|
|
31982
|
+
"minLength": 1,
|
|
31983
|
+
"description": "Previously configured VETH"
|
|
31307
31984
|
},
|
|
31308
31985
|
"root_dir": {
|
|
31309
|
-
"
|
|
31310
|
-
"
|
|
31986
|
+
"type": "string",
|
|
31987
|
+
"minLength": 1,
|
|
31988
|
+
"description": "Dedicated root path on verified storage"
|
|
31311
31989
|
},
|
|
31312
31990
|
"env": {
|
|
31313
|
-
"description": "
|
|
31991
|
+
"description": "Sensitive inline environment; verify support on the target",
|
|
31314
31992
|
"type": "string"
|
|
31315
31993
|
},
|
|
31316
31994
|
"envlists": {
|
|
31317
|
-
"description": "
|
|
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
|
|
32003
|
+
"description": "Inline mount expression supported by the target; not Docker syntax",
|
|
31322
32004
|
"type": "string"
|
|
31323
32005
|
},
|
|
31324
32006
|
"mountlists": {
|
|
31325
|
-
"description": "
|
|
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": "
|
|
32015
|
+
"description": "Command override; may contain secrets",
|
|
31330
32016
|
"type": "string"
|
|
31331
32017
|
},
|
|
31332
32018
|
"entrypoint": {
|
|
31333
|
-
"description": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
31397
|
-
"type": "string"
|
|
32101
|
+
"description": "Exact unique container name",
|
|
32102
|
+
"type": "string",
|
|
32103
|
+
"minLength": 1
|
|
31398
32104
|
},
|
|
31399
32105
|
"tag": {
|
|
31400
|
-
"description": "
|
|
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
|
-
"
|
|
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
|
-
"
|
|
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": "
|
|
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": "
|
|
31470
|
-
"type": "string"
|
|
32214
|
+
"description": "Exact unique container name",
|
|
32215
|
+
"type": "string",
|
|
32216
|
+
"minLength": 1
|
|
31471
32217
|
},
|
|
31472
32218
|
"tag": {
|
|
31473
|
-
"description": "
|
|
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": "
|
|
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": "
|
|
31495
|
-
"type": "string"
|
|
32246
|
+
"description": "Exact unique container name",
|
|
32247
|
+
"type": "string",
|
|
32248
|
+
"minLength": 1
|
|
31496
32249
|
},
|
|
31497
32250
|
"tag": {
|
|
31498
|
-
"description": "
|
|
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": "
|
|
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": "
|
|
31521
|
-
"type": "string"
|
|
32279
|
+
"description": "Exact unique container name",
|
|
32280
|
+
"type": "string",
|
|
32281
|
+
"minLength": 1
|
|
31522
32282
|
},
|
|
31523
32283
|
"tag": {
|
|
31524
|
-
"description": "
|
|
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
|
|
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": "
|
|
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
|
-
"
|
|
32330
|
+
"type": "string"
|
|
32331
|
+
},
|
|
32332
|
+
"memory_high": {
|
|
31572
32333
|
"type": "string"
|
|
31573
32334
|
},
|
|
31574
32335
|
"ram_high": {
|
|
31575
|
-
"description": "
|
|
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
|
|
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
|
|
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": "
|
|
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
|
|
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
|
-
"
|
|
32386
|
+
"minLength": 1
|
|
31628
32387
|
},
|
|
31629
32388
|
"key": {
|
|
31630
32389
|
"type": "string",
|
|
31631
|
-
"
|
|
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": "
|
|
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
|
-
"
|
|
32421
|
+
"minLength": 1
|
|
31659
32422
|
},
|
|
31660
32423
|
"key": {
|
|
31661
32424
|
"type": "string",
|
|
31662
|
-
"
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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
|
-
"
|
|
32479
|
+
"minLength": 1
|
|
31707
32480
|
},
|
|
31708
32481
|
"src": {
|
|
31709
32482
|
"type": "string",
|
|
31710
|
-
"
|
|
32483
|
+
"minLength": 1
|
|
31711
32484
|
},
|
|
31712
32485
|
"dst": {
|
|
31713
32486
|
"type": "string",
|
|
31714
|
-
"
|
|
32487
|
+
"minLength": 1
|
|
31715
32488
|
}
|
|
31716
32489
|
},
|
|
31717
|
-
"required": ["
|
|
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": "
|
|
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
|
-
"
|
|
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
|
},
|