@usex/mikrotik-mcp 5.18.0 → 5.19.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": "5.18.0",
3
+ "version": "5.19.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 931 tools: `name`, `risk`, `title`, `description`, and input JSON Schema. |
10
+ | `tool-catalog.json` | Every one of the 937 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": "5.18.0",
3
+ "version": "5.19.0",
4
4
  "modules": [
5
5
  {
6
6
  "slug": "client-check",
@@ -120,6 +120,21 @@
120
120
  "alwaysOn": true,
121
121
  "tools": ["check_server_pulse"]
122
122
  },
123
+ {
124
+ "slug": "mcp-settings",
125
+ "label": "MCP Settings",
126
+ "group": "Discovery & Meta",
127
+ "description": "Read, validate, preview and safely update MCP host settings with local backups, revision checks and timed rollback. Never changes routers, credentials or access ceilings.",
128
+ "alwaysOn": false,
129
+ "tools": [
130
+ "get_mcp_settings",
131
+ "get_mcp_settings_schema",
132
+ "preview_mcp_settings",
133
+ "update_mcp_settings",
134
+ "confirm_mcp_settings",
135
+ "rollback_mcp_settings"
136
+ ]
137
+ },
123
138
  {
124
139
  "slug": "device-capabilities",
125
140
  "label": "Device Capabilities",
@@ -2504,6 +2519,62 @@
2504
2519
  "requires": null,
2505
2520
  "ui": null
2506
2521
  },
2522
+ {
2523
+ "name": "get_mcp_settings",
2524
+ "module": "mcp-settings",
2525
+ "group": "Discovery & Meta",
2526
+ "noDevice": true,
2527
+ "requires": null,
2528
+ "ui": {
2529
+ "resourceUri": "ui://mikrotik/records.html?v=2",
2530
+ "visibility": ["model", "app"],
2531
+ "automatic": true
2532
+ }
2533
+ },
2534
+ {
2535
+ "name": "get_mcp_settings_schema",
2536
+ "module": "mcp-settings",
2537
+ "group": "Discovery & Meta",
2538
+ "noDevice": true,
2539
+ "requires": null,
2540
+ "ui": {
2541
+ "resourceUri": "ui://mikrotik/records.html?v=2",
2542
+ "visibility": ["model", "app"],
2543
+ "automatic": true
2544
+ }
2545
+ },
2546
+ {
2547
+ "name": "preview_mcp_settings",
2548
+ "module": "mcp-settings",
2549
+ "group": "Discovery & Meta",
2550
+ "noDevice": true,
2551
+ "requires": null,
2552
+ "ui": null
2553
+ },
2554
+ {
2555
+ "name": "update_mcp_settings",
2556
+ "module": "mcp-settings",
2557
+ "group": "Discovery & Meta",
2558
+ "noDevice": true,
2559
+ "requires": null,
2560
+ "ui": null
2561
+ },
2562
+ {
2563
+ "name": "confirm_mcp_settings",
2564
+ "module": "mcp-settings",
2565
+ "group": "Discovery & Meta",
2566
+ "noDevice": true,
2567
+ "requires": null,
2568
+ "ui": null
2569
+ },
2570
+ {
2571
+ "name": "rollback_mcp_settings",
2572
+ "module": "mcp-settings",
2573
+ "group": "Discovery & Meta",
2574
+ "noDevice": true,
2575
+ "requires": null,
2576
+ "ui": null
2577
+ },
2507
2578
  {
2508
2579
  "name": "get_device_capabilities",
2509
2580
  "module": "device-capabilities",
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "version": "5.18.0",
3
+ "version": "5.19.0",
4
4
  "generated": "by scripts/gen-schemas.ts — do not edit by hand",
5
- "toolCount": 931,
5
+ "toolCount": 937,
6
6
  "tools": [
7
7
  {
8
8
  "name": "create_client_check",
@@ -1339,6 +1339,319 @@
1339
1339
  "additionalProperties": false
1340
1340
  }
1341
1341
  },
1342
+ {
1343
+ "name": "get_mcp_settings",
1344
+ "title": "Read MCP Server Settings",
1345
+ "risk": "read",
1346
+ "annotations": {
1347
+ "readOnlyHint": true,
1348
+ "idempotentHint": true,
1349
+ "openWorldHint": false
1350
+ },
1351
+ "description": "Read the MCP host's editable settings, opaque revision and pending change. Covers tool presentation, SSH pooling, dashboard recording, Memory enablement and startup update checks. Contains no credentials; never contacts a router. These are configured values, not proof a startup-only component has restarted. Read before preview_mcp_settings or update_mcp_settings.",
1352
+ "inputSchema": {
1353
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1354
+ "type": "object",
1355
+ "properties": {},
1356
+ "additionalProperties": false
1357
+ }
1358
+ },
1359
+ {
1360
+ "name": "get_mcp_settings_schema",
1361
+ "title": "Describe Editable MCP Settings",
1362
+ "risk": "read",
1363
+ "annotations": {
1364
+ "readOnlyHint": true,
1365
+ "idempotentHint": true,
1366
+ "openWorldHint": false
1367
+ },
1368
+ "description": "Get the exact JSON Schema for the partial changes accepted by preview_mcp_settings and update_mcp_settings. Unknown/protected fields are rejected, omitted fields stay unchanged. Credentials, listeners, file paths, device inventory and permission ceilings are operator-managed. No device or file changes.",
1369
+ "inputSchema": {
1370
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1371
+ "type": "object",
1372
+ "properties": {},
1373
+ "additionalProperties": false
1374
+ }
1375
+ },
1376
+ {
1377
+ "name": "preview_mcp_settings",
1378
+ "title": "Validate and Preview MCP Settings",
1379
+ "risk": "read",
1380
+ "annotations": {
1381
+ "readOnlyHint": true,
1382
+ "idempotentHint": true,
1383
+ "openWorldHint": false
1384
+ },
1385
+ "description": "Validate a partial MCP settings change against live configuration and return changed paths, a secret-free diff, revision and restart requirements. No file writes or router contact. Show the preview and obtain user approval before applying; never guess setting names.",
1386
+ "inputSchema": {
1387
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1388
+ "type": "object",
1389
+ "properties": {
1390
+ "changes": {
1391
+ "type": "object",
1392
+ "properties": {
1393
+ "mcp": {
1394
+ "type": "object",
1395
+ "properties": {
1396
+ "toolPageSize": {
1397
+ "type": "integer",
1398
+ "minimum": 0,
1399
+ "maximum": 9007199254740991
1400
+ },
1401
+ "appViews": {
1402
+ "type": "boolean"
1403
+ },
1404
+ "capabilityGating": {
1405
+ "type": "string",
1406
+ "enum": ["off", "annotate", "filter"]
1407
+ }
1408
+ },
1409
+ "additionalProperties": false
1410
+ },
1411
+ "ssh": {
1412
+ "type": "object",
1413
+ "properties": {
1414
+ "keepAlive": {
1415
+ "type": "boolean"
1416
+ },
1417
+ "keepAliveInterval": {
1418
+ "type": "integer",
1419
+ "minimum": 0,
1420
+ "maximum": 9007199254740991
1421
+ },
1422
+ "idleTimeout": {
1423
+ "type": "integer",
1424
+ "exclusiveMinimum": 0,
1425
+ "maximum": 9007199254740991
1426
+ }
1427
+ },
1428
+ "additionalProperties": false
1429
+ },
1430
+ "dashboard": {
1431
+ "type": "object",
1432
+ "properties": {
1433
+ "maxEvents": {
1434
+ "type": "integer",
1435
+ "exclusiveMinimum": 0,
1436
+ "maximum": 9007199254740991
1437
+ },
1438
+ "captureBody": {
1439
+ "type": "boolean"
1440
+ },
1441
+ "redactInput": {
1442
+ "description": "May enable redaction, never disable it.",
1443
+ "type": "boolean",
1444
+ "const": true
1445
+ },
1446
+ "maxBodyBytes": {
1447
+ "type": "integer",
1448
+ "minimum": 0,
1449
+ "maximum": 9007199254740991
1450
+ },
1451
+ "feedLimit": {
1452
+ "type": "integer",
1453
+ "exclusiveMinimum": 0,
1454
+ "maximum": 10000
1455
+ }
1456
+ },
1457
+ "additionalProperties": false
1458
+ },
1459
+ "memory": {
1460
+ "type": "object",
1461
+ "properties": {
1462
+ "enabled": {
1463
+ "type": "boolean"
1464
+ }
1465
+ },
1466
+ "additionalProperties": false
1467
+ },
1468
+ "disableUpdateCheck": {
1469
+ "type": "boolean"
1470
+ }
1471
+ },
1472
+ "additionalProperties": false,
1473
+ "description": "Only the fields to change; omitted values are preserved."
1474
+ }
1475
+ },
1476
+ "required": ["changes"],
1477
+ "additionalProperties": false
1478
+ }
1479
+ },
1480
+ {
1481
+ "name": "update_mcp_settings",
1482
+ "title": "Safely Update MCP Settings",
1483
+ "risk": "write",
1484
+ "annotations": {
1485
+ "destructiveHint": false,
1486
+ "openWorldHint": false
1487
+ },
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.",
1489
+ "inputSchema": {
1490
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1491
+ "type": "object",
1492
+ "properties": {
1493
+ "changes": {
1494
+ "type": "object",
1495
+ "properties": {
1496
+ "mcp": {
1497
+ "type": "object",
1498
+ "properties": {
1499
+ "toolPageSize": {
1500
+ "type": "integer",
1501
+ "minimum": 0,
1502
+ "maximum": 9007199254740991
1503
+ },
1504
+ "appViews": {
1505
+ "type": "boolean"
1506
+ },
1507
+ "capabilityGating": {
1508
+ "type": "string",
1509
+ "enum": ["off", "annotate", "filter"]
1510
+ }
1511
+ },
1512
+ "additionalProperties": false
1513
+ },
1514
+ "ssh": {
1515
+ "type": "object",
1516
+ "properties": {
1517
+ "keepAlive": {
1518
+ "type": "boolean"
1519
+ },
1520
+ "keepAliveInterval": {
1521
+ "type": "integer",
1522
+ "minimum": 0,
1523
+ "maximum": 9007199254740991
1524
+ },
1525
+ "idleTimeout": {
1526
+ "type": "integer",
1527
+ "exclusiveMinimum": 0,
1528
+ "maximum": 9007199254740991
1529
+ }
1530
+ },
1531
+ "additionalProperties": false
1532
+ },
1533
+ "dashboard": {
1534
+ "type": "object",
1535
+ "properties": {
1536
+ "maxEvents": {
1537
+ "type": "integer",
1538
+ "exclusiveMinimum": 0,
1539
+ "maximum": 9007199254740991
1540
+ },
1541
+ "captureBody": {
1542
+ "type": "boolean"
1543
+ },
1544
+ "redactInput": {
1545
+ "description": "May enable redaction, never disable it.",
1546
+ "type": "boolean",
1547
+ "const": true
1548
+ },
1549
+ "maxBodyBytes": {
1550
+ "type": "integer",
1551
+ "minimum": 0,
1552
+ "maximum": 9007199254740991
1553
+ },
1554
+ "feedLimit": {
1555
+ "type": "integer",
1556
+ "exclusiveMinimum": 0,
1557
+ "maximum": 10000
1558
+ }
1559
+ },
1560
+ "additionalProperties": false
1561
+ },
1562
+ "memory": {
1563
+ "type": "object",
1564
+ "properties": {
1565
+ "enabled": {
1566
+ "type": "boolean"
1567
+ }
1568
+ },
1569
+ "additionalProperties": false
1570
+ },
1571
+ "disableUpdateCheck": {
1572
+ "type": "boolean"
1573
+ }
1574
+ },
1575
+ "additionalProperties": false
1576
+ },
1577
+ "revision": {
1578
+ "type": "string",
1579
+ "minLength": 64,
1580
+ "maxLength": 64,
1581
+ "description": "Current revision from get_mcp_settings or preview_mcp_settings."
1582
+ },
1583
+ "confirm": {
1584
+ "type": "boolean",
1585
+ "const": true,
1586
+ "description": "Only set after the user authorizes these exact changes."
1587
+ },
1588
+ "rollback_seconds": {
1589
+ "default": 60,
1590
+ "type": "integer",
1591
+ "minimum": 30,
1592
+ "maximum": 600
1593
+ }
1594
+ },
1595
+ "required": ["changes", "revision", "confirm", "rollback_seconds"],
1596
+ "additionalProperties": false
1597
+ }
1598
+ },
1599
+ {
1600
+ "name": "confirm_mcp_settings",
1601
+ "title": "Keep a Pending MCP Settings Change",
1602
+ "risk": "write",
1603
+ "annotations": {
1604
+ "destructiveHint": false,
1605
+ "openWorldHint": false
1606
+ },
1607
+ "description": "Keep the exact pending change created by update_mcp_settings after reading back its values. Cancels its rollback timer. Requires the current revision and pending_id; cannot confirm dashboard-owned, expired or superseded changes. Does not restart the MCP server or contact routers.",
1608
+ "inputSchema": {
1609
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1610
+ "type": "object",
1611
+ "properties": {
1612
+ "pending_id": {
1613
+ "type": "string",
1614
+ "minLength": 1
1615
+ },
1616
+ "revision": {
1617
+ "type": "string",
1618
+ "minLength": 64,
1619
+ "maxLength": 64,
1620
+ "description": "Revision returned by update_mcp_settings or get_mcp_settings."
1621
+ }
1622
+ },
1623
+ "required": ["pending_id", "revision"],
1624
+ "additionalProperties": false
1625
+ }
1626
+ },
1627
+ {
1628
+ "name": "rollback_mcp_settings",
1629
+ "title": "Revert a Pending MCP Settings Change",
1630
+ "risk": "write",
1631
+ "annotations": {
1632
+ "destructiveHint": false,
1633
+ "openWorldHint": false
1634
+ },
1635
+ "description": "Restore the host-side config backup for a still-pending update_mcp_settings change. Requires its pending_id and current revision. Refuses dashboard-owned transactions or changes that would overwrite newer configuration. Restores configured values only; no router changes, server restart or deletion of knowledge data.",
1636
+ "inputSchema": {
1637
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1638
+ "type": "object",
1639
+ "properties": {
1640
+ "pending_id": {
1641
+ "type": "string",
1642
+ "minLength": 1
1643
+ },
1644
+ "revision": {
1645
+ "type": "string",
1646
+ "minLength": 64,
1647
+ "maxLength": 64,
1648
+ "description": "Revision returned by update_mcp_settings or get_mcp_settings."
1649
+ }
1650
+ },
1651
+ "required": ["pending_id", "revision"],
1652
+ "additionalProperties": false
1653
+ }
1654
+ },
1342
1655
  {
1343
1656
  "name": "get_device_capabilities",
1344
1657
  "title": "Get Device Capabilities",
@@ -0,0 +1,19 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "confirm_mcp_settings",
4
+ "type": "object",
5
+ "properties": {
6
+ "pending_id": {
7
+ "type": "string",
8
+ "minLength": 1
9
+ },
10
+ "revision": {
11
+ "type": "string",
12
+ "minLength": 64,
13
+ "maxLength": 64,
14
+ "description": "Revision returned by update_mcp_settings or get_mcp_settings."
15
+ }
16
+ },
17
+ "required": ["pending_id", "revision"],
18
+ "additionalProperties": false
19
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "get_mcp_settings",
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_mcp_settings_schema",
4
+ "type": "object",
5
+ "properties": {},
6
+ "additionalProperties": false
7
+ }
@@ -0,0 +1,94 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "preview_mcp_settings",
4
+ "type": "object",
5
+ "properties": {
6
+ "changes": {
7
+ "type": "object",
8
+ "properties": {
9
+ "mcp": {
10
+ "type": "object",
11
+ "properties": {
12
+ "toolPageSize": {
13
+ "type": "integer",
14
+ "minimum": 0,
15
+ "maximum": 9007199254740991
16
+ },
17
+ "appViews": {
18
+ "type": "boolean"
19
+ },
20
+ "capabilityGating": {
21
+ "type": "string",
22
+ "enum": ["off", "annotate", "filter"]
23
+ }
24
+ },
25
+ "additionalProperties": false
26
+ },
27
+ "ssh": {
28
+ "type": "object",
29
+ "properties": {
30
+ "keepAlive": {
31
+ "type": "boolean"
32
+ },
33
+ "keepAliveInterval": {
34
+ "type": "integer",
35
+ "minimum": 0,
36
+ "maximum": 9007199254740991
37
+ },
38
+ "idleTimeout": {
39
+ "type": "integer",
40
+ "exclusiveMinimum": 0,
41
+ "maximum": 9007199254740991
42
+ }
43
+ },
44
+ "additionalProperties": false
45
+ },
46
+ "dashboard": {
47
+ "type": "object",
48
+ "properties": {
49
+ "maxEvents": {
50
+ "type": "integer",
51
+ "exclusiveMinimum": 0,
52
+ "maximum": 9007199254740991
53
+ },
54
+ "captureBody": {
55
+ "type": "boolean"
56
+ },
57
+ "redactInput": {
58
+ "description": "May enable redaction, never disable it.",
59
+ "type": "boolean",
60
+ "const": true
61
+ },
62
+ "maxBodyBytes": {
63
+ "type": "integer",
64
+ "minimum": 0,
65
+ "maximum": 9007199254740991
66
+ },
67
+ "feedLimit": {
68
+ "type": "integer",
69
+ "exclusiveMinimum": 0,
70
+ "maximum": 10000
71
+ }
72
+ },
73
+ "additionalProperties": false
74
+ },
75
+ "memory": {
76
+ "type": "object",
77
+ "properties": {
78
+ "enabled": {
79
+ "type": "boolean"
80
+ }
81
+ },
82
+ "additionalProperties": false
83
+ },
84
+ "disableUpdateCheck": {
85
+ "type": "boolean"
86
+ }
87
+ },
88
+ "additionalProperties": false,
89
+ "description": "Only the fields to change; omitted values are preserved."
90
+ }
91
+ },
92
+ "required": ["changes"],
93
+ "additionalProperties": false
94
+ }
@@ -0,0 +1,19 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "rollback_mcp_settings",
4
+ "type": "object",
5
+ "properties": {
6
+ "pending_id": {
7
+ "type": "string",
8
+ "minLength": 1
9
+ },
10
+ "revision": {
11
+ "type": "string",
12
+ "minLength": 64,
13
+ "maxLength": 64,
14
+ "description": "Revision returned by update_mcp_settings or get_mcp_settings."
15
+ }
16
+ },
17
+ "required": ["pending_id", "revision"],
18
+ "additionalProperties": false
19
+ }