@usex/mikrotik-mcp 3.27.0 → 3.29.0

package/schemas/tools/add_container.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "add_container",
+  "type": "object",
+  "properties": {
+    "name": {
+      "description": "Container name (recommended for management)",
+      "type": "string"
+    },
+    "remote_image": {
+      "description": "Registry image, e.g. 'library/alpine:latest'",
+      "type": "string"
+    },
+    "file": {
+      "description": "Local Docker-v1 tar on the device (alternative to remote_image)",
+      "type": "string"
+    },
+    "interface": {
+      "description": "VETH interface name",
+      "type": "string"
+    },
+    "root_dir": {
+      "description": "Filesystem root, e.g. 'disk1/myapp'",
+      "type": "string"
+    },
+    "env": {
+      "description": "Inline env vars: 'K=v,K2=v2' (7.21+)",
+      "type": "string"
+    },
+    "envlists": {
+      "description": "Named env list name(s) (add_container_env)",
+      "type": "string"
+    },
+    "mount": {
+      "description": "Inline mount: 'src=disk1/data,dst=/data' (7.21+)",
+      "type": "string"
+    },
+    "mountlists": {
+      "description": "Named mount name(s) (add_container_mount)",
+      "type": "string"
+    },
+    "cmd": {
+      "description": "Override container CMD",
+      "type": "string"
+    },
+    "entrypoint": {
+      "description": "Override container ENTRYPOINT",
+      "type": "string"
+    },
+    "workdir": {
+      "description": "Override working directory",
+      "type": "string"
+    },
+    "hostname": {
+      "type": "string"
+    },
+    "dns": {
+      "description": "DNS server for the container",
+      "type": "string"
+    },
+    "user": {
+      "type": "string"
+    },
+    "stop_signal": {
+      "description": "Signal used to stop the container",
+      "type": "string"
+    },
+    "devices": {
+      "description": "Pass-through physical devices (7.20+)",
+      "type": "string"
+    },
+    "cpu_list": {
+      "description": "CPU core affinity",
+      "type": "string"
+    },
+    "memory_high": {
+      "description": "RAM limit, e.g. '256M'",
+      "type": "string"
+    },
+    "logging": {
+      "description": "Send stdout/stderr to the RouterOS log",
+      "type": "boolean"
+    },
+    "start_on_boot": {
+      "description": "Auto-start on device boot",
+      "type": "boolean"
+    },
+    "comment": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/add_container_env.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "add_container_env",
+  "type": "object",
+  "properties": {
+    "list": {
+      "type": "string",
+      "description": "Env-list (group) name, e.g. 'MYAPP'"
+    },
+    "key": {
+      "type": "string",
+      "description": "Variable name, e.g. 'TZ'"
+    },
+    "value": {
+      "type": "string",
+      "description": "Variable value"
+    }
+  },
+  "required": ["list", "key", "value"],
+  "additionalProperties": false
+}

package/schemas/tools/add_container_mount.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "add_container_mount",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Mount name, e.g. 'appdata'"
+    },
+    "src": {
+      "type": "string",
+      "description": "Host source path, e.g. 'disk1/appdata'"
+    },
+    "dst": {
+      "type": "string",
+      "description": "Container destination path, e.g. '/data'"
+    }
+  },
+  "required": ["name", "src", "dst"],
+  "additionalProperties": false
+}

package/schemas/tools/add_disk.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "add_disk",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "description": "Virtual disk type: 'raid', 'rsync', 'tmpfs', 'encrypted', …"
+    },
+    "slot": {
+      "description": "Name/slot for the new virtual disk",
+      "type": "string"
+    },
+    "raid_type": {
+      "description": "For type=raid, e.g. 'raid1', 'raid5'",
+      "type": "string"
+    },
+    "tmpfs_max_size": {
+      "description": "For type=tmpfs, e.g. '256M'",
+      "type": "string"
+    },
+    "comment": {
+      "type": "string"
+    },
+    "properties": {
+      "description": "Extra RouterOS attribute=value pairs for this disk type",
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "string"
+      }
+    }
+  },
+  "required": ["type"],
+  "additionalProperties": false
+}

package/schemas/tools/eject_disk.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "eject_disk",
+  "type": "object",
+  "properties": {
+    "slot": {
+      "type": "string",
+      "description": "Disk slot to eject, e.g. 'usb1'"
+    }
+  },
+  "required": ["slot"],
+  "additionalProperties": false
+}

package/schemas/tools/format_disk.json

@@ -3,24 +3,36 @@
   "title": "format_disk",
   "type": "object",
   "properties": {
-    "name": {
+    "slot": {
       "type": "string",
-      "description": "Disk name to format, e.g. 'disk1'"
+      "description": "Disk slot to format, e.g. 'usb1'"
     },
     "file_system": {
-      "description": "File system to create",
+      "description": "Filesystem to create (RouterOS can format these)",
       "type": "string",
-      "enum": ["ext4", "fat32", "exfat", "ntfs"]
+      "enum": ["ext4", "exfat", "fat32", "ntfs"]
     },
     "label": {
       "description": "Volume label",
       "type": "string"
     },
+    "partition_size": {
+      "description": "Format only this much as a partition, e.g. '10G' (omit = whole drive)",
+      "type": "string"
+    },
+    "encryption": {
+      "description": "Encryption algorithm to enable, e.g. 'aes-cbc' (RouterOS value)",
+      "type": "string"
+    },
+    "encryption_password": {
+      "description": "Passphrase when encryption is set",
+      "type": "string"
+    },
     "confirm": {
       "type": "boolean",
-      "description": "Must be true to actually erase the disk"
+      "description": "Must be true to actually ERASE the disk"
     }
   },
-  "required": ["name", "confirm"],
+  "required": ["slot", "confirm"],
   "additionalProperties": false
 }

package/schemas/tools/get_container.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "get_container",
+  "type": "object",
+  "properties": {
+    "name": {
+      "description": "Container name (set via add_container)",
+      "type": "string"
+    },
+    "tag": {
+      "description": "Image tag to match (e.g. 'pihole') if no name",
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/get_container_config.json

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

package/schemas/tools/get_disk.json

@@ -3,11 +3,11 @@
   "title": "get_disk",
   "type": "object",
   "properties": {
-    "name": {
+    "slot": {
       "type": "string",
-      "description": "Disk name, e.g. 'disk1'"
+      "description": "Disk slot, e.g. 'nvme1', 'usb1'"
     }
   },
-  "required": ["name"],
+  "required": ["slot"],
   "additionalProperties": false
 }

package/schemas/tools/list_container_envs.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "list_container_envs",
+  "type": "object",
+  "properties": {
+    "list_filter": {
+      "description": "Partial env-list (group) name match",
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/list_container_mounts.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "list_container_mounts",
+  "type": "object",
+  "properties": {
+    "name_filter": {
+      "description": "Partial mount name match",
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/list_containers.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "list_containers",
+  "type": "object",
+  "properties": {
+    "name_filter": {
+      "description": "Partial container name match",
+      "type": "string"
+    },
+    "tag_filter": {
+      "description": "Partial image tag match",
+      "type": "string"
+    },
+    "status_filter": {
+      "description": "e.g. 'running', 'stopped'",
+      "type": "string"
+    },
+    "detail": {
+      "default": false,
+      "description": "Show the full per-container property block",
+      "type": "boolean"
+    }
+  },
+  "required": ["detail"],
+  "additionalProperties": false
+}

package/schemas/tools/list_disks.json

@@ -2,6 +2,25 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "list_disks",
   "type": "object",
-  "properties": {},
+  "properties": {
+    "slot_filter": {
+      "description": "Partial slot match, e.g. 'usb'",
+      "type": "string"
+    },
+    "type_filter": {
+      "description": "Partial type match, e.g. 'raid', 'partition'",
+      "type": "string"
+    },
+    "interface_filter": {
+      "description": "Partial interface match, e.g. 'nvme', 'usb'",
+      "type": "string"
+    },
+    "detail": {
+      "default": false,
+      "description": "Show the full per-disk property block",
+      "type": "boolean"
+    }
+  },
+  "required": ["detail"],
   "additionalProperties": false
 }

package/schemas/tools/remove_container.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "remove_container",
+  "type": "object",
+  "properties": {
+    "name": {
+      "description": "Container name (set via add_container)",
+      "type": "string"
+    },
+    "tag": {
+      "description": "Image tag to match (e.g. 'pihole') if no name",
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/remove_container_env.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "remove_container_env",
+  "type": "object",
+  "properties": {
+    "list": {
+      "type": "string",
+      "description": "Env-list (group) name"
+    },
+    "key": {
+      "type": "string",
+      "description": "Variable name to remove"
+    }
+  },
+  "required": ["list", "key"],
+  "additionalProperties": false
+}

package/schemas/tools/remove_container_mount.json

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

package/schemas/tools/remove_disk.json

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

package/schemas/tools/set_container_config.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "set_container_config",
+  "type": "object",
+  "properties": {
+    "registry_url": {
+      "description": "Image registry URL",
+      "type": "string"
+    },
+    "tmpdir": {
+      "description": "Pull/extract temp dir, e.g. 'disk1/pull'",
+      "type": "string"
+    },
+    "layer_dir": {
+      "description": "Directory for extracted image layers",
+      "type": "string"
+    },
+    "ram_high": {
+      "description": "RAM-high limit, e.g. '256M'",
+      "type": "string"
+    },
+    "username": {
+      "description": "Registry username (private registries)",
+      "type": "string"
+    },
+    "password": {
+      "description": "Registry password (private registries)",
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/set_disk.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "set_disk",
+  "type": "object",
+  "properties": {
+    "slot": {
+      "type": "string",
+      "description": "Disk slot to modify"
+    },
+    "label": {
+      "description": "Volume / disk label",
+      "type": "string"
+    },
+    "comment": {
+      "type": "string"
+    },
+    "raid_master": {
+      "description": "Slot of the RAID disk to make this a member of",
+      "type": "string"
+    },
+    "parent": {
+      "description": "Parent disk slot to attach under",
+      "type": "string"
+    },
+    "disabled": {
+      "type": "boolean"
+    }
+  },
+  "required": ["slot"],
+  "additionalProperties": false
+}

package/schemas/tools/share_disk.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "share_disk",
+  "type": "object",
+  "properties": {
+    "slot": {
+      "type": "string",
+      "description": "Disk slot to share"
+    },
+    "smb_sharing": {
+      "description": "Enable/disable SMB (CIFS) sharing",
+      "type": "boolean"
+    },
+    "smb_share_name": {
+      "description": "SMB share name shown to clients",
+      "type": "string"
+    },
+    "smb_users": {
+      "description": "Comma-separated SMB users allowed to access the share",
+      "type": "string"
+    },
+    "nfs_sharing": {
+      "description": "Enable/disable NFS sharing",
+      "type": "boolean"
+    }
+  },
+  "required": ["slot"],
+  "additionalProperties": false
+}

package/schemas/tools/start_container.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "start_container",
+  "type": "object",
+  "properties": {
+    "name": {
+      "description": "Container name (set via add_container)",
+      "type": "string"
+    },
+    "tag": {
+      "description": "Image tag to match (e.g. 'pihole') if no name",
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/stop_container.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "stop_container",
+  "type": "object",
+  "properties": {
+    "name": {
+      "description": "Container name (set via add_container)",
+      "type": "string"
+    },
+    "tag": {
+      "description": "Image tag to match (e.g. 'pihole') if no name",
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/update_container.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "update_container",
+  "type": "object",
+  "properties": {
+    "name": {
+      "description": "Container name (set via add_container)",
+      "type": "string"
+    },
+    "tag": {
+      "description": "Image tag to match (e.g. 'pihole') if no name",
+      "type": "string"
+    },
+    "interface": {
+      "type": "string"
+    },
+    "root_dir": {
+      "type": "string"
+    },
+    "env": {
+      "type": "string"
+    },
+    "envlists": {
+      "type": "string"
+    },
+    "mount": {
+      "type": "string"
+    },
+    "mountlists": {
+      "type": "string"
+    },
+    "cmd": {
+      "type": "string"
+    },
+    "entrypoint": {
+      "type": "string"
+    },
+    "workdir": {
+      "type": "string"
+    },
+    "hostname": {
+      "type": "string"
+    },
+    "dns": {
+      "type": "string"
+    },
+    "cpu_list": {
+      "type": "string"
+    },
+    "memory_high": {
+      "type": "string"
+    },
+    "logging": {
+      "type": "boolean"
+    },
+    "start_on_boot": {
+      "type": "boolean"
+    },
+    "comment": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/tools/upload_file.json

@@ -4,10 +4,12 @@
   "type": "object",
   "properties": {
     "filename": {
-      "type": "string"
+      "type": "string",
+      "description": "Destination path on the device, e.g. 'config.rsc' or 'disk1/cert.pem'"
     },
     "content_base64": {
-      "type": "string"
+      "type": "string",
+      "description": "File bytes, base64-encoded (binary-safe)"
     }
   },
   "required": ["filename", "content_base64"],