@usex/mikrotik-mcp 6.7.0 → 6.8.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@usex/mikrotik-mcp",
3
- "version": "6.7.0",
3
+ "version": "6.8.0",
4
4
  "description": "MCP server for MikroTik RouterOS — 780+ tools over SSH for firewall, NAT, routing, DHCP, DNS, WireGuard, wireless, QoS and more.",
5
5
  "keywords": [
6
6
  "ai",
package/schemas/README.md CHANGED
@@ -7,7 +7,7 @@ edit by hand — regenerate instead.
7
7
  | File | Contents |
8
8
  | -------------------- | ------------------------------------------------------------------------------------------ |
9
9
  | `config.schema.json` | The runtime configuration object (env vars / CLI flags). |
10
- | `tool-catalog.json` | Every one of the 972 tools: `name`, `risk`, `title`, `description`, and input JSON Schema. |
10
+ | `tool-catalog.json` | Every one of the 981 tools: `name`, `risk`, `title`, `description`, and input JSON Schema. |
11
11
  | `tools/<name>.json` | The input JSON Schema for a single tool. |
12
12
 
13
13
  `risk` is derived from the MCP tool annotations:
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "format": 1,
3
- "version": "6.7.0",
3
+ "version": "6.8.0",
4
4
  "modules": [
5
5
  {
6
6
  "slug": "client-check",
@@ -944,6 +944,22 @@
944
944
  "create_basic_firewall_setup"
945
945
  ]
946
946
  },
947
+ {
948
+ "slug": "web-proxy",
949
+ "label": "Web Proxy",
950
+ "group": "Security",
951
+ "description": "HTTP/HTTPS CONNECT proxy settings, live status and ordered access rules (`/ip proxy`).",
952
+ "alwaysOn": false,
953
+ "tools": [
954
+ "get_web_proxy",
955
+ "update_web_proxy",
956
+ "monitor_web_proxy",
957
+ "list_web_proxy_access_rules",
958
+ "add_web_proxy_access_rule",
959
+ "remove_web_proxy_access_rule",
960
+ "move_web_proxy_access_rule"
961
+ ]
962
+ },
947
963
  {
948
964
  "slug": "firewall-nat",
949
965
  "label": "Firewall — NAT",
@@ -1571,6 +1587,14 @@
1571
1587
  "shutdown_system"
1572
1588
  ]
1573
1589
  },
1590
+ {
1591
+ "slug": "device-mode",
1592
+ "label": "Device Mode",
1593
+ "group": "System & Ops",
1594
+ "description": "Read device-mode capabilities and request physically confirmed feature changes.",
1595
+ "alwaysOn": false,
1596
+ "tools": ["get_device_mode", "update_device_mode_features"]
1597
+ },
1574
1598
  {
1575
1599
  "slug": "system-config",
1576
1600
  "label": "System Config",
@@ -6103,6 +6127,70 @@
6103
6127
  "requires": null,
6104
6128
  "ui": null
6105
6129
  },
6130
+ {
6131
+ "name": "get_web_proxy",
6132
+ "module": "web-proxy",
6133
+ "group": "Security",
6134
+ "noDevice": false,
6135
+ "requires": null,
6136
+ "ui": {
6137
+ "resourceUri": "ui://mikrotik/records.html?v=2",
6138
+ "visibility": ["model", "app"],
6139
+ "automatic": true
6140
+ }
6141
+ },
6142
+ {
6143
+ "name": "update_web_proxy",
6144
+ "module": "web-proxy",
6145
+ "group": "Security",
6146
+ "noDevice": false,
6147
+ "requires": null,
6148
+ "ui": null
6149
+ },
6150
+ {
6151
+ "name": "monitor_web_proxy",
6152
+ "module": "web-proxy",
6153
+ "group": "Security",
6154
+ "noDevice": false,
6155
+ "requires": null,
6156
+ "ui": null
6157
+ },
6158
+ {
6159
+ "name": "list_web_proxy_access_rules",
6160
+ "module": "web-proxy",
6161
+ "group": "Security",
6162
+ "noDevice": false,
6163
+ "requires": null,
6164
+ "ui": {
6165
+ "resourceUri": "ui://mikrotik/records.html?v=2",
6166
+ "visibility": ["model", "app"],
6167
+ "automatic": true
6168
+ }
6169
+ },
6170
+ {
6171
+ "name": "add_web_proxy_access_rule",
6172
+ "module": "web-proxy",
6173
+ "group": "Security",
6174
+ "noDevice": false,
6175
+ "requires": null,
6176
+ "ui": null
6177
+ },
6178
+ {
6179
+ "name": "remove_web_proxy_access_rule",
6180
+ "module": "web-proxy",
6181
+ "group": "Security",
6182
+ "noDevice": false,
6183
+ "requires": null,
6184
+ "ui": null
6185
+ },
6186
+ {
6187
+ "name": "move_web_proxy_access_rule",
6188
+ "module": "web-proxy",
6189
+ "group": "Security",
6190
+ "noDevice": false,
6191
+ "requires": null,
6192
+ "ui": null
6193
+ },
6106
6194
  {
6107
6195
  "name": "create_nat_rule",
6108
6196
  "module": "firewall-nat",
@@ -9109,6 +9197,26 @@
9109
9197
  "requires": null,
9110
9198
  "ui": null
9111
9199
  },
9200
+ {
9201
+ "name": "get_device_mode",
9202
+ "module": "device-mode",
9203
+ "group": "System & Ops",
9204
+ "noDevice": false,
9205
+ "requires": null,
9206
+ "ui": {
9207
+ "resourceUri": "ui://mikrotik/records.html?v=2",
9208
+ "visibility": ["model", "app"],
9209
+ "automatic": true
9210
+ }
9211
+ },
9212
+ {
9213
+ "name": "update_device_mode_features",
9214
+ "module": "device-mode",
9215
+ "group": "System & Ops",
9216
+ "noDevice": false,
9217
+ "requires": null,
9218
+ "ui": null
9219
+ },
9112
9220
  {
9113
9221
  "name": "list_system_console",
9114
9222
  "module": "system-config",
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "version": "6.7.0",
3
+ "version": "6.8.0",
4
4
  "generated": "by scripts/gen-schemas.ts — do not edit by hand",
5
- "toolCount": 972,
5
+ "toolCount": 981,
6
6
  "tools": [
7
7
  {
8
8
  "name": "create_client_check",
@@ -15211,6 +15211,178 @@
15211
15211
  "additionalProperties": false
15212
15212
  }
15213
15213
  },
15214
+ {
15215
+ "name": "get_web_proxy",
15216
+ "title": "Get Web Proxy Settings",
15217
+ "risk": "read",
15218
+ "annotations": {
15219
+ "readOnlyHint": true,
15220
+ "idempotentHint": true,
15221
+ "openWorldHint": false
15222
+ },
15223
+ "description": "Read RouterOS `/ip proxy` settings, including enabled, port, outgoing source and cache.",
15224
+ "inputSchema": {
15225
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
15226
+ "type": "object",
15227
+ "properties": {},
15228
+ "additionalProperties": false
15229
+ }
15230
+ },
15231
+ {
15232
+ "name": "update_web_proxy",
15233
+ "title": "Update Web Proxy Settings",
15234
+ "risk": "dangerous",
15235
+ "annotations": {
15236
+ "destructiveHint": true,
15237
+ "openWorldHint": false
15238
+ },
15239
+ "description": "Configure RouterOS `/ip proxy`. Enabling a listener does not restrict who may connect: configure IPv4/IPv6 input firewall rules and inspect web proxy access rules first. The outgoing src_address can select existing source-based policy routing; verify the route and NAT separately.",
15240
+ "inputSchema": {
15241
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
15242
+ "type": "object",
15243
+ "properties": {
15244
+ "enabled": {
15245
+ "type": "boolean"
15246
+ },
15247
+ "port": {
15248
+ "type": "integer",
15249
+ "minimum": 1,
15250
+ "maximum": 65535
15251
+ },
15252
+ "src_address": {
15253
+ "type": "string"
15254
+ },
15255
+ "anonymous": {
15256
+ "type": "boolean"
15257
+ },
15258
+ "max_cache_size": {
15259
+ "type": "string"
15260
+ },
15261
+ "confirm_firewall_ready": {
15262
+ "description": "Required when enabling: IPv4 and IPv6 input firewall access has been verified.",
15263
+ "type": "boolean"
15264
+ }
15265
+ },
15266
+ "additionalProperties": false
15267
+ }
15268
+ },
15269
+ {
15270
+ "name": "monitor_web_proxy",
15271
+ "title": "Monitor Web Proxy",
15272
+ "risk": "read",
15273
+ "annotations": {
15274
+ "readOnlyHint": true,
15275
+ "idempotentHint": true,
15276
+ "openWorldHint": false
15277
+ },
15278
+ "description": "Read one `/ip proxy monitor once` sample, including connection and request counters.",
15279
+ "inputSchema": {
15280
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
15281
+ "type": "object",
15282
+ "properties": {},
15283
+ "additionalProperties": false
15284
+ }
15285
+ },
15286
+ {
15287
+ "name": "list_web_proxy_access_rules",
15288
+ "title": "List Web Proxy Access Rules",
15289
+ "risk": "read",
15290
+ "annotations": {
15291
+ "readOnlyHint": true,
15292
+ "idempotentHint": true,
15293
+ "openWorldHint": false
15294
+ },
15295
+ "description": "Read ordered `/ip proxy access` rules and their `.id`s. An unmatched request is allowed by RouterOS; use firewall input rules to control source address lists.",
15296
+ "inputSchema": {
15297
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
15298
+ "type": "object",
15299
+ "properties": {},
15300
+ "additionalProperties": false
15301
+ }
15302
+ },
15303
+ {
15304
+ "name": "add_web_proxy_access_rule",
15305
+ "title": "Add Web Proxy Access Rule",
15306
+ "risk": "write",
15307
+ "annotations": {
15308
+ "destructiveHint": false,
15309
+ "openWorldHint": false
15310
+ },
15311
+ "description": "Add an allow/deny rule to `/ip proxy access`. Order matters; place_before is an existing `.id` or zero-based row. Use dst_address to block private targets; the proxy firewall controls client sources.",
15312
+ "inputSchema": {
15313
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
15314
+ "type": "object",
15315
+ "properties": {
15316
+ "action": {
15317
+ "type": "string",
15318
+ "enum": ["allow", "deny"]
15319
+ },
15320
+ "src_address": {
15321
+ "type": "string"
15322
+ },
15323
+ "dst_address": {
15324
+ "type": "string"
15325
+ },
15326
+ "comment": {
15327
+ "type": "string"
15328
+ },
15329
+ "place_before": {
15330
+ "type": "string"
15331
+ }
15332
+ },
15333
+ "required": ["action"],
15334
+ "additionalProperties": false
15335
+ }
15336
+ },
15337
+ {
15338
+ "name": "remove_web_proxy_access_rule",
15339
+ "title": "Remove Web Proxy Access Rule",
15340
+ "risk": "destructive",
15341
+ "annotations": {
15342
+ "destructiveHint": true,
15343
+ "idempotentHint": true,
15344
+ "openWorldHint": false
15345
+ },
15346
+ "description": "Remove one `/ip proxy access` rule by `.id` or zero-based row, after inspecting the ordered list.",
15347
+ "inputSchema": {
15348
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
15349
+ "type": "object",
15350
+ "properties": {
15351
+ "rule_id": {
15352
+ "type": "string"
15353
+ }
15354
+ },
15355
+ "required": ["rule_id"],
15356
+ "additionalProperties": false
15357
+ }
15358
+ },
15359
+ {
15360
+ "name": "move_web_proxy_access_rule",
15361
+ "title": "Move Web Proxy Access Rule",
15362
+ "risk": "write-idempotent",
15363
+ "annotations": {
15364
+ "destructiveHint": false,
15365
+ "idempotentHint": true,
15366
+ "openWorldHint": false
15367
+ },
15368
+ "description": "Move one `/ip proxy access` rule before the item at a zero-based destination position; reads back the resulting order.",
15369
+ "inputSchema": {
15370
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
15371
+ "type": "object",
15372
+ "properties": {
15373
+ "rule_id": {
15374
+ "type": "string"
15375
+ },
15376
+ "destination": {
15377
+ "type": "integer",
15378
+ "minimum": 0,
15379
+ "maximum": 9007199254740991
15380
+ }
15381
+ },
15382
+ "required": ["rule_id", "destination"],
15383
+ "additionalProperties": false
15384
+ }
15385
+ },
15214
15386
  {
15215
15387
  "name": "create_nat_rule",
15216
15388
  "title": "Create IPv4 Firewall NAT Rule",
@@ -26515,6 +26687,131 @@
26515
26687
  "additionalProperties": false
26516
26688
  }
26517
26689
  },
26690
+ {
26691
+ "name": "get_device_mode",
26692
+ "title": "Get RouterOS Device Mode",
26693
+ "risk": "read",
26694
+ "annotations": {
26695
+ "readOnlyHint": true,
26696
+ "idempotentHint": true,
26697
+ "openWorldHint": false
26698
+ },
26699
+ "description": "Read `/system device-mode print` to see which restricted RouterOS features are available and whether physical confirmation is pending.",
26700
+ "inputSchema": {
26701
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
26702
+ "type": "object",
26703
+ "properties": {},
26704
+ "additionalProperties": false
26705
+ }
26706
+ },
26707
+ {
26708
+ "name": "update_device_mode_features",
26709
+ "title": "Request Device Mode Feature Update",
26710
+ "risk": "dangerous",
26711
+ "annotations": {
26712
+ "destructiveHint": true,
26713
+ "openWorldHint": false
26714
+ },
26715
+ "description": "Request any RouterOS device-mode feature or mode setting. Changing mode replaces existing per-feature overrides; inspect get_device_mode first. Clearing flagged requires a security audit. Every update needs physical confirmation and a reboot; the command response only confirms a pending request. Read back after confirmation. Unsupported properties depend on RouterOS version and hardware.",
26716
+ "inputSchema": {
26717
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
26718
+ "type": "object",
26719
+ "properties": {
26720
+ "mode": {
26721
+ "description": "Changes the entire mode and resets prior per-feature overrides; include any overrides to keep in this request.",
26722
+ "type": "string",
26723
+ "enum": ["home", "basic", "advanced", "rose"]
26724
+ },
26725
+ "scheduler": {
26726
+ "type": "boolean"
26727
+ },
26728
+ "socks": {
26729
+ "type": "boolean"
26730
+ },
26731
+ "fetch": {
26732
+ "type": "boolean"
26733
+ },
26734
+ "pptp": {
26735
+ "type": "boolean"
26736
+ },
26737
+ "l2tp": {
26738
+ "type": "boolean"
26739
+ },
26740
+ "bandwidth_test": {
26741
+ "type": "boolean"
26742
+ },
26743
+ "traffic_gen": {
26744
+ "type": "boolean"
26745
+ },
26746
+ "sniffer": {
26747
+ "type": "boolean"
26748
+ },
26749
+ "ipsec": {
26750
+ "type": "boolean"
26751
+ },
26752
+ "romon": {
26753
+ "type": "boolean"
26754
+ },
26755
+ "proxy": {
26756
+ "type": "boolean"
26757
+ },
26758
+ "hotspot": {
26759
+ "type": "boolean"
26760
+ },
26761
+ "smb": {
26762
+ "type": "boolean"
26763
+ },
26764
+ "email": {
26765
+ "type": "boolean"
26766
+ },
26767
+ "zerotier": {
26768
+ "type": "boolean"
26769
+ },
26770
+ "container": {
26771
+ "type": "boolean"
26772
+ },
26773
+ "install_any_version": {
26774
+ "type": "boolean"
26775
+ },
26776
+ "partitions": {
26777
+ "type": "boolean"
26778
+ },
26779
+ "routerboard": {
26780
+ "type": "boolean"
26781
+ },
26782
+ "activation_timeout": {
26783
+ "description": "Physical confirmation window, 10 seconds to 1 day (RouterOS duration, e.g. 5m or 00:05:00).",
26784
+ "type": "string",
26785
+ "minLength": 1,
26786
+ "maxLength": 20
26787
+ },
26788
+ "flagging_enabled": {
26789
+ "type": "boolean"
26790
+ },
26791
+ "flagged": {
26792
+ "description": "Set false only after a security audit of the router configuration.",
26793
+ "type": "boolean"
26794
+ },
26795
+ "confirm_mode_resets_overrides": {
26796
+ "description": "Required with mode: existing per-feature overrides will be reset unless included in this request.",
26797
+ "type": "boolean",
26798
+ "const": true
26799
+ },
26800
+ "confirm_flagged_audit_complete": {
26801
+ "description": "Required to clear flagged after auditing configuration, passwords, and RouterOS version.",
26802
+ "type": "boolean",
26803
+ "const": true
26804
+ },
26805
+ "physical_confirmation_available": {
26806
+ "type": "boolean",
26807
+ "const": true,
26808
+ "description": "Operator is physically present and has authorized the device-mode change."
26809
+ }
26810
+ },
26811
+ "required": ["physical_confirmation_available"],
26812
+ "additionalProperties": false
26813
+ }
26814
+ },
26518
26815
  {
26519
26816
  "name": "list_system_console",
26520
26817
  "title": "List System Console Sessions",
@@ -0,0 +1,25 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "add_web_proxy_access_rule",
4
+ "type": "object",
5
+ "properties": {
6
+ "action": {
7
+ "type": "string",
8
+ "enum": ["allow", "deny"]
9
+ },
10
+ "src_address": {
11
+ "type": "string"
12
+ },
13
+ "dst_address": {
14
+ "type": "string"
15
+ },
16
+ "comment": {
17
+ "type": "string"
18
+ },
19
+ "place_before": {
20
+ "type": "string"
21
+ }
22
+ },
23
+ "required": ["action"],
24
+ "additionalProperties": false
25
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "get_device_mode",
4
+ "type": "object",
5
+ "properties": {},
6
+ "additionalProperties": false
7
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "get_web_proxy",
4
+ "type": "object",
5
+ "properties": {},
6
+ "additionalProperties": false
7
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "list_web_proxy_access_rules",
4
+ "type": "object",
5
+ "properties": {},
6
+ "additionalProperties": false
7
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "monitor_web_proxy",
4
+ "type": "object",
5
+ "properties": {},
6
+ "additionalProperties": false
7
+ }
@@ -0,0 +1,17 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "move_web_proxy_access_rule",
4
+ "type": "object",
5
+ "properties": {
6
+ "rule_id": {
7
+ "type": "string"
8
+ },
9
+ "destination": {
10
+ "type": "integer",
11
+ "minimum": 0,
12
+ "maximum": 9007199254740991
13
+ }
14
+ },
15
+ "required": ["rule_id", "destination"],
16
+ "additionalProperties": false
17
+ }
@@ -0,0 +1,12 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "remove_web_proxy_access_rule",
4
+ "type": "object",
5
+ "properties": {
6
+ "rule_id": {
7
+ "type": "string"
8
+ }
9
+ },
10
+ "required": ["rule_id"],
11
+ "additionalProperties": false
12
+ }
@@ -0,0 +1,99 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "update_device_mode_features",
4
+ "type": "object",
5
+ "properties": {
6
+ "mode": {
7
+ "description": "Changes the entire mode and resets prior per-feature overrides; include any overrides to keep in this request.",
8
+ "type": "string",
9
+ "enum": ["home", "basic", "advanced", "rose"]
10
+ },
11
+ "scheduler": {
12
+ "type": "boolean"
13
+ },
14
+ "socks": {
15
+ "type": "boolean"
16
+ },
17
+ "fetch": {
18
+ "type": "boolean"
19
+ },
20
+ "pptp": {
21
+ "type": "boolean"
22
+ },
23
+ "l2tp": {
24
+ "type": "boolean"
25
+ },
26
+ "bandwidth_test": {
27
+ "type": "boolean"
28
+ },
29
+ "traffic_gen": {
30
+ "type": "boolean"
31
+ },
32
+ "sniffer": {
33
+ "type": "boolean"
34
+ },
35
+ "ipsec": {
36
+ "type": "boolean"
37
+ },
38
+ "romon": {
39
+ "type": "boolean"
40
+ },
41
+ "proxy": {
42
+ "type": "boolean"
43
+ },
44
+ "hotspot": {
45
+ "type": "boolean"
46
+ },
47
+ "smb": {
48
+ "type": "boolean"
49
+ },
50
+ "email": {
51
+ "type": "boolean"
52
+ },
53
+ "zerotier": {
54
+ "type": "boolean"
55
+ },
56
+ "container": {
57
+ "type": "boolean"
58
+ },
59
+ "install_any_version": {
60
+ "type": "boolean"
61
+ },
62
+ "partitions": {
63
+ "type": "boolean"
64
+ },
65
+ "routerboard": {
66
+ "type": "boolean"
67
+ },
68
+ "activation_timeout": {
69
+ "description": "Physical confirmation window, 10 seconds to 1 day (RouterOS duration, e.g. 5m or 00:05:00).",
70
+ "type": "string",
71
+ "minLength": 1,
72
+ "maxLength": 20
73
+ },
74
+ "flagging_enabled": {
75
+ "type": "boolean"
76
+ },
77
+ "flagged": {
78
+ "description": "Set false only after a security audit of the router configuration.",
79
+ "type": "boolean"
80
+ },
81
+ "confirm_mode_resets_overrides": {
82
+ "description": "Required with mode: existing per-feature overrides will be reset unless included in this request.",
83
+ "type": "boolean",
84
+ "const": true
85
+ },
86
+ "confirm_flagged_audit_complete": {
87
+ "description": "Required to clear flagged after auditing configuration, passwords, and RouterOS version.",
88
+ "type": "boolean",
89
+ "const": true
90
+ },
91
+ "physical_confirmation_available": {
92
+ "type": "boolean",
93
+ "const": true,
94
+ "description": "Operator is physically present and has authorized the device-mode change."
95
+ }
96
+ },
97
+ "required": ["physical_confirmation_available"],
98
+ "additionalProperties": false
99
+ }