Creates a system backup on the MikroTik device.

Lists backup files on the MikroTik device.

Creates a configuration export file (rsc/json/xml) on the MikroTik device.

Returns a RouterOS configuration section as an export script.

Notes: section: RouterOS path without leading slash e.g. "ip address", "interface vlan", "ip firewall filter", "ip firewall nat", "queue simple" hide_sensitive: keep secrets out of the output (False appends show-sensitive)

Downloads a backup or export file from the MikroTik device as base64-encoded content.

Uploads a base64-encoded file to the MikroTik device (for restore operations).

Restores a system backup on the MikroTik device; triggers a reboot.

Imports and executes a RouterOS configuration script (.rsc file) on the device.

Removes a file from the MikroTik device filesystem.

Gets detailed information about a backup file on the MikroTik device.

Creates a DHCP server bound to the specified interface on the MikroTik device.

Notes: lease_time: duration e.g. "1d", "12h", "30m", "1h30m"

Lists DHCP servers on the MikroTik device.

Lists detailed IPv4 DHCP leases, optionally filtering active lease fields.

Notes: Address and identity filters are substring matches. Server, status, and lease time filters are exact matches against RouterOS lease-time.

Lists detailed DHCPv6 bindings.

Notes: Address and DUID filters are substring matches. IAID, server, status, and lease time filters are exact matches; lease time maps to life-time.

Gets detailed information about a specific DHCP server.

Creates a DHCP network configuration (gateway, DNS, domain, etc.) on the MikroTik device.

Updates fields on an existing DHCP network entry on the MikroTik device.

Notes: Pass an empty list for dns_servers/wins_servers/ntp_servers/dhcp_option (or "" for domain) to clear that field.

Removes a DHCP network configuration from the MikroTik device.

Creates a DHCP address pool with the given IP ranges on the MikroTik device.

Notes: ranges: hyphen-separated range(s) e.g. "192.168.1.1-192.168.1.100" Multiple ranges comma-separated: "10.0.0.1-10.0.0.50,10.0.0.100-10.0.0.120"

Removes a DHCP server from the MikroTik device.

Sets DNS server configuration.

Gets current DNS configuration.

Adds a static DNS entry.

Lists static DNS entries.

Gets details of a specific static DNS entry.

Updates a static DNS entry.

Removes a static DNS entry.

Enables a static DNS entry.

Disables a static DNS entry.

Gets the current DNS cache.

Flushes the DNS cache.

Gets DNS cache statistics.

Adds a DNS regexp entry.

Tests a DNS query.

Notes: type: accepted values are A/ipv4, AAAA/ipv6, any, any6

Exports DNS configuration to a file.

Adds an entry to an IPv4 or IPv6 firewall address list.

Notes: address: an address or prefix; a hostname is also accepted and RouterOS adds a dynamic child entry per resolved address. timeout: RouterOS duration e.g. "1h". An entry with a timeout is dynamic, so it does not survive a reboot. list_name is matched exactly, including any leading or trailing spaces.

Lists IPv4 or IPv6 firewall address list entries.

Notes: list_filter: exact list name, including any trailing space. address_filter/comment_filter: partial match. static_only excludes the dynamic children a hostname entry creates.

Gets one address list entry by list name and address.

Updates an address list entry, located by its current list name and address.

Notes: Pass "" to clear comment or timeout. A change is confirmed on the device before success is reported.

Removes an address list entry by list name and address.

Notes: Removing a hostname entry also clears the dynamic entries RouterOS derived from it.

Enables an address list entry.

Disables an address list entry.

Creates a firewall filter rule in the specified chain on the MikroTik device.

Notes: connection_state: comma-separated e.g. "established,related,new,invalid" limit: RouterOS rate/burst string e.g. "10,5:packet" or "10/1s:packet" tcp_flags: RouterOS flag expression e.g. "syn,!ack" place_before: rule number or ID (*N) to insert before e.g. "0" or "*3" in_interface_list/out_interface_list: name of an /interface list (e.g. "LAN", "WAN") rather than a single interface

Lists firewall filter rules on the MikroTik device.

Gets detailed information about a specific firewall filter rule.

Notes: rule_id: positional number from list output (e.g. "12") or internal ID (e.g. "*1A")

Updates an existing firewall filter rule on the MikroTik device.

Notes: rule_id: positional number from list output (e.g. "12") or internal ID (e.g. "*1A") connection_state: comma-separated e.g. "established,related" limit: RouterOS rate string e.g. "10,5:packet" tcp_flags: RouterOS flag expression e.g. "syn,!ack" Pass "" to clear an optional field (e.g. src_address="").

Removes a firewall filter rule from the MikroTik device.

Notes: rule_id: positional number from list output (e.g. "12") or internal ID (e.g. "*1A")

Moves a firewall filter rule to a different position in the chain.

Notes: rule_id: positional number from list output (e.g. "12") or internal ID (e.g. "*1A") destination: 0-based target position index

Enables a firewall filter rule.

Disables a firewall filter rule.

Creates a basic firewall setup with common security rules on the MikroTik device.

Creates a NAT rule (srcnat or dstnat) on the MikroTik device.

Notes: to_addresses: single IP or range e.g. "10.0.0.1" or "10.0.0.1-10.0.0.10" to_ports: single port or range e.g. "8080" or "8080-8090" place_before: rule number or ID (*N) to insert before e.g. "0" or "*3"

Lists NAT rules on the MikroTik device.

Gets detailed information about a specific NAT rule.

Notes: rule_id: use the ID from list output e.g. "*1" or "0"

Updates an existing NAT rule on the MikroTik device.

Notes: rule_id: use the ID from list output e.g. "*1" or "0" to_addresses: single IP or range e.g. "10.0.0.1" or "10.0.0.1-10.0.0.10" to_ports: single port or range e.g. "8080" or "8080-8090" Pass "" to clear an optional field.

Removes a NAT rule from the MikroTik device.

Notes: rule_id: use the ID from list output e.g. "*1" or "0"

Moves a NAT rule to a different position in the chain.

Notes: rule_id: use the ID from list output e.g. "*1" or "0" destination: 0-based target position index

Enables a NAT rule.

Disables a NAT rule.

Lists all interfaces on the MikroTik device (ethernet, bridge, WireGuard, PPPoE, VLAN, WiFi, SFP, LTE, loopback, and any other type).

Notes: type_filter: RouterOS interface type e.g. "ether", "bridge", "vlan", "wg", "pppoe-out", "wifi", "lte", "loopback" name_filter: partial name match e.g. "ether" matches ether1, ether2 …

Gets detailed information about a specific interface by name.

Notes: name: exact interface name e.g. "ether1", "bridge", "pppoe-out1", "wg0"

Enables an interface on the MikroTik device.

Notes: name: exact interface name e.g. "ether1", "bridge", "pppoe-out1"

Disables an interface on the MikroTik device.

Notes: name: exact interface name e.g. "ether1", "bridge", "pppoe-out1"

Lists the MikroTik devices this server manages.

Use this to discover which devices are available and what their titles are. Every other tool takes an optional device argument that must be one of the titles returned here. When only one device is configured, device may be omitted and that device is used automatically.

Credentials are never returned.

Adds an IP address to an interface on the MikroTik device.

Lists IP addresses on the MikroTik device.

Gets detailed information about a specific IP address by ID or address value.

Removes an IP address from the MikroTik device by ID or address value.

Adds an IPv6 address to an interface on the MikroTik device.

Notes: address: IPv6 address with prefix length, e.g. "2001:db8::1/64" or "fe80::1/64". When from_pool is used, supply the host part only, e.g. "::1/64". advertise: include this prefix in Router Advertisements (default no). eui_64: derive the host part of the address from the interface MAC. from_pool: name of an IPv6 pool to take the prefix from. no_dad: skip Duplicate Address Detection.

Lists IPv6 addresses on the MikroTik device.

Notes: address_filter: partial match on the address, e.g. "2001:db8" or "fe80". global_only: show only global (routable) addresses. link_local_only: show only link-local (fe80::/10) addresses.

Gets detailed information about a specific IPv6 address by ID or address value.

Notes: address_id: a RouterOS internal id (e.g. "*1") or the address value (e.g. "2001:db8::1/64").

Removes an IPv6 address from the MikroTik device by ID or address value.

Notes: address_id: a RouterOS internal id (e.g. "*1") or the address value (e.g. "2001:db8::1/64").

Creates an IPv6 firewall filter rule on the MikroTik device.

Notes: protocol: IPv6 uses "icmpv6", not the IPv4 spelling "icmp". jump_target: only used with action="jump".

Lists IPv6 firewall filter rules on the MikroTik device.

Notes: protocol_filter: IPv6 uses "icmpv6", not the IPv4 spelling "icmp". src_address_filter/dst_address_filter: partial match on the address, e.g. "2001:db8" matches every rule whose address starts with it.

Gets detailed information about a specific IPv6 firewall filter rule.

Notes: rule_id: a RouterOS internal id ("*1") or a print position ("0").

Updates an existing IPv6 firewall filter rule on the MikroTik device.

Notes: rule_id: a RouterOS internal id ("*1") or a print position ("0"). Pass "" to clear an optional field (e.g. src_address="").

Removes an IPv6 firewall filter rule from the MikroTik device.

Notes: rule_id: a RouterOS internal id ("*1") or a print position ("0").

Moves an IPv6 firewall filter rule to a different position in the chain.

Notes: rule_id: a RouterOS internal id ("*1") or a print position ("0"). destination: 0-based target position index

Enables an IPv6 firewall filter rule.

Disables an IPv6 firewall filter rule.

Creates an IP pool with the given address ranges on the MikroTik device.

Notes: ranges: hyphen-separated range(s) e.g. "192.168.1.1-192.168.1.100" Multiple ranges comma-separated: "10.0.0.1-10.0.0.50,10.0.0.100-10.0.0.120"

Lists IP pools on the MikroTik device.

Gets detailed information about a specific IP pool including used address count.

Updates an existing IP pool's name, ranges, or next-pool reference.

Notes: ranges: hyphen-separated range(s) e.g. "192.168.1.1-192.168.1.100" Multiple ranges comma-separated: "10.0.0.1-10.0.0.50,10.0.0.100-10.0.0.120" Pass "" for next_pool to clear it.

Removes an IP pool from the MikroTik device (fails if pool is in use).

Lists currently used (allocated) addresses from IP pools.

Expands an existing IP pool by appending additional address ranges.

Notes: additional_ranges: hyphen-separated range(s) e.g. "192.168.1.101-192.168.1.150" Multiple ranges comma-separated: "10.0.0.51-10.0.0.60,10.0.0.70-10.0.0.80"

Gets logs from the MikroTik device with optional topic, time, and message filters.

Notes: topics: comma-separated, entry matches any of them e.g. "system,dhcp" time_filter: RouterOS duration e.g. "30s", "5m", "1h", "2d" message_filter: RouterOS regex matched against the message (case-sensitive) limit: keep only the newest N entries

Gets logs filtered by severity level (debug/info/warning/error/critical).

Gets logs for a specific topic/facility (system, dhcp, interface, firewall, etc.).

Searches log messages for a literal term.

Notes: search_term: treated literally (regex specials are escaped) case_sensitive: RouterOS matching is case-sensitive; by default the search emulates case-insensitivity with character classes

Gets system-related log events (login, reboot, config-change, etc.).

Gets security-related log entries (logins, failures, blocked connections, etc.).

Explains why MikroTik's in-memory log cannot be cleared on demand.

Gets log entry counts by topic and severity from the MikroTik device.

Exports logs to a .txt file on the MikroTik device with optional topic and time filters.

Watches for new log entries for a limited duration (max 60s) and returns them.

Notes: duration: seconds to wait for new entries, capped at 60

Lists detailed IPv4 ARP entries.

Notes: Address and MAC filters are substring matches. Interface and status filters are exact matches.

Lists detailed IPv6 neighbor-discovery entries.

Notes: Address and MAC filters are substring matches. Interface and status filters are exact matches.

Reads real-time Power-over-Ethernet (PoE) monitor data for one or more ethernet interfaces — PoE-out status, voltage, current, and power.

Runs /interface ethernet poe monitor <interfaces> once.

Notes: interfaces: comma-separated ethernet interface name(s), e.g. "ether1" or "ether9-ap,ether10-ap,ether11-ap,ether12-ap"

Lists the Power-over-Ethernet (PoE) configuration of PoE-capable ethernet interfaces (PoE-out mode, priority).

Runs /interface ethernet poe print.

Notes: interface_filter: partial name match, e.g. "ether" matches ether1, ether2 …

Gets the detailed PoE-out settings of a specific ethernet interface (PoE-out mode, priority, voltage, low/high thresholds, …).

Runs /interface ethernet poe print detail where name=<name>.

Notes: name: exact ethernet interface name, e.g. "ether1"

Creates a queue type (qdisc). kind selects the discipline (cake, fq-codel, sfq, red, pcq, pfifo, bfifo); remaining params are per-discipline options.

Notes: pcq_rate: bandwidth per flow e.g. "1M", "512k" pcq_classifier: comma-separated classifiers e.g. "src-address,dst-address" cake_rtt: round-trip time e.g. "50ms", "100ms" fq_codel_target / fq_codel_interval: time e.g. "5ms", "100ms"

Lists queue types on the MikroTik device.

Gets detailed information about a specific queue type.

Updates an existing queue type's discipline-specific settings.

Removes a queue type from the MikroTik device.

Creates a hierarchical queue tree entry attached to a parent interface or queue.

Notes: max_limit / limit_at / burst_limit / burst_threshold: bandwidth e.g. "10M", "512k", "1G" burst_time: duration e.g. "8s" parent: interface name e.g. "ether1" or parent queue name priority: 1 (highest) – 8 (lowest)

Lists queue trees on the MikroTik device.

Gets detailed information about a specific queue tree.

Updates an existing queue tree entry (bandwidth limits, parent, priority, etc.).

Notes: max_limit / limit_at / burst_limit / burst_threshold: bandwidth e.g. "10M", "512k" burst_time: duration e.g. "8s" priority: 1 (highest) – 8 (lowest)

Removes a queue tree from the MikroTik device.

Enables a queue tree.

Disables a queue tree.

Creates a simple queue to rate-limit a target address or interface.

Notes: target: IP/CIDR or interface e.g. "192.168.1.0/24" or "ether1" max_limit / limit_at / burst_limit / burst_threshold: upload/download bandwidth as "UL/DL" e.g. "10M/10M", or single value e.g. "10M" burst_time: duration e.g. "8s" priority: 1 (highest) – 8 (lowest)

Lists simple queues on the MikroTik device.

Gets detailed information about a specific simple queue.

Updates an existing simple queue's rate limits, target, or scheduling settings.

Notes: target: IP/CIDR or interface e.g. "192.168.1.0/24" or "ether1" max_limit / limit_at / burst_limit / burst_threshold: upload/download bandwidth as "UL/DL" e.g. "10M/10M", or single value e.g. "10M" burst_time: duration e.g. "8s" priority: 1 (highest) – 8 (lowest)

Removes a simple queue from the MikroTik device.

Enables a simple queue.

Disables a simple queue.

Returns whether MikroTik Safe Mode is currently active.

Activates MikroTik Safe Mode; changes are held in memory and auto-reverted on disconnect until committed.

Commits all pending Safe Mode changes to persistent storage and exits Safe Mode.

Discards all pending Safe Mode changes by closing the SSH session, triggering automatic rollback.

Adds a route to the routing table.

Notes: dst_address: CIDR e.g. "0.0.0.0/0", "192.168.1.0/24" routing_table: name of a table from /routing table, e.g. "via_ISP2"; defaults to "main". RouterOS 6 called this the routing mark. check_gateway: "ping" or "arp" distance: 1-255 (lower = higher priority)

Lists routes in MikroTik routing table.

Gets detailed information about a specific route.

Notes: route_id: "*N" or "N" from list output e.g. "*3"

Updates a route.

Notes: route_id: "*N" or "N" from list output e.g. "*3" dst_address: CIDR e.g. "192.168.1.0/24" check_gateway: "ping" or "arp" distance: 1-255 routing_table: name of a table from /routing table; "" moves the route back to "main", since every RouterOS 7 route belongs to a table. Pass "" to vrf_interface or pref_src to clear them.

Removes a route.

Notes: route_id: "*N" or "N" from list output e.g. "*3"

Enables a route.

Notes: route_id: "*N" or "N" from list output e.g. "*3"

Disables a route.

Notes: route_id: "*N" or "N" from list output e.g. "*3"

Gets a specific routing table.

Checks the route MikroTik would use to reach a destination.

Gets the route cache.

Flushes the route cache.

Adds a default route.

Adds a blackhole route.

Notes: dst_address: CIDR e.g. "10.0.0.0/8" distance: 1-255

Gets routing table statistics.

Adds a user to MikroTik device.

Lists users on MikroTik device.

Gets detailed information about a specific user.

Updates a user.

Removes a user.

Disables a user.

Enables a user.

Adds a user group.

Lists user groups on MikroTik device.

Gets detailed information about a specific user group.

Updates a user group.

Removes a user group.

Gets currently active/logged-in users.

Disconnects an active user session.

Exports user configuration to a file.

Sets SSH keys for a specific user.

Lists SSH keys for a specific user.

Removes an SSH key.

Creates a VLAN interface on the MikroTik device with the given VLAN ID and parent interface.

Lists VLAN interfaces on the MikroTik device.

Gets detailed information about a specific VLAN interface.

Updates an existing VLAN interface's settings on the MikroTik device.

Removes a VLAN interface from the MikroTik device.

Creates a wireless interface on the MikroTik device (auto-detects RouterOS v6/v7 syntax).

Lists wireless interfaces on the MikroTik device.

Gets detailed information about a specific wireless interface.

Removes a wireless interface from the MikroTik device.

Enables a wireless interface.

Disables a wireless interface.

Scans for nearby wireless networks using the specified interface.

Gets the wireless registration table (connected clients) from the MikroTik device.

Checks if the device supports wireless and reports the RouterOS version and wireless interface type.

Legacy function - not supported in RouterOS v7.x

Legacy function - not supported in RouterOS v7.x

Legacy function - not supported in RouterOS v7.x

Legacy function - not supported in RouterOS v7.x

Legacy function - not supported in RouterOS v7.x

Legacy function - different in RouterOS v7.x

Legacy function - different in RouterOS v7.x

Legacy function - different in RouterOS v7.x

Updates an existing wireless interface's settings (name, SSID, enabled state, etc.).

Sets the WiFi passphrase directly on a RouterOS v7 wireless interface (/interface wifi or wifiwave2).

Notes: authentication_types: comma-separated RouterOS auth types, e.g. "wpa2-psk,wpa3-psk"; unset keeps the current setting.

Creates a WireGuard interface on the MikroTik device.

Lists WireGuard interfaces on the MikroTik device.

Gets detailed information about a specific WireGuard interface.

Updates an existing WireGuard interface's settings on the MikroTik device.

Removes a WireGuard interface from the MikroTik device.

Enables a WireGuard interface.

Disables a WireGuard interface.

Adds a WireGuard peer (with public key and allowed addresses) to an interface on the MikroTik device.

Notes: allowed_address: CIDR, comma-separated for multiple e.g. "10.0.0.2/32" or "10.0.0.0/24,192.168.0.0/24" endpoint_address: remote host IP or hostname e.g. "203.0.113.1" persistent_keepalive: seconds as string e.g. "25"

Lists WireGuard peers on the MikroTik device.

Gets detailed information about a specific WireGuard peer by ID.

Notes: peer_id: "*N" or "N" from list output e.g. "*2"

Updates an existing WireGuard peer's allowed addresses, endpoint, keepalive, or enabled state.

Notes: peer_id: "*N" or "N" from list output e.g. "*2" allowed_address: CIDR, comma-separated e.g. "10.0.0.2/32" or "10.0.0.0/24,192.168.0.0/24" persistent_keepalive: seconds as string e.g. "25" Pass "" for endpoint_address or preshared_key to clear them.

Removes a WireGuard peer from the MikroTik device.

Notes: peer_id: "*N" or "N" from list output e.g. "*2"

Enables a WireGuard peer.

Notes: peer_id: "*N" or "N" from list output e.g. "*2"

Disables a WireGuard peer.

Notes: peer_id: "*N" or "N" from list output e.g. "*2"

Generates a wg0.conf client config string from the given keys and server endpoint. Does not communicate with the router.