Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server manages one or more MikroTik devices. Every tool accepts an optional device argument: the title of the target device, as listed by list_devices. Omit it when a single device is configured; when several are, it is required. Titles match case-insensitively, and an omitted or unknown device returns an error naming the valid titles.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_devicesA

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.

safe_mode_statusA

Returns whether MikroTik Safe Mode is currently active.

enable_safe_modeA

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

commit_safe_modeA

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

rollback_safe_modeA

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

create_dhcp_serverC

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

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

list_dhcp_serversB

Lists DHCP servers on the MikroTik device.

list_dhcp_leasesA

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.

list_dhcpv6_bindingsA

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.

get_dhcp_serverB

Gets detailed information about a specific DHCP server.

create_dhcp_networkC

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

update_dhcp_networkB

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.

remove_dhcp_networkC

Removes a DHCP network configuration from the MikroTik device.

create_dhcp_poolC

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"

remove_dhcp_serverC

Removes a DHCP server from the MikroTik device.

set_dns_serversC

Sets DNS server configuration.

get_dns_settingsC

Gets current DNS configuration.

add_dns_staticC

Adds a static DNS entry.

Notes: regexp: a regular expression the name must match. A regexp entry has no name, so name is ignored when regexp is given (RouterOS refuses both: "only name or regexp allowed").

list_dns_staticB

Lists static DNS entries.

get_dns_staticA

Gets details of a specific static DNS entry.

update_dns_staticD

Updates a static DNS entry.

remove_dns_staticC

Removes a static DNS entry.

enable_dns_staticC

Enables a static DNS entry.

disable_dns_staticC

Disables a static DNS entry.

get_dns_cacheB

Gets the current DNS cache.

flush_dns_cacheC

Flushes the DNS cache.

get_dns_cache_statisticsC

Gets DNS cache statistics.

add_dns_regexpC

Adds a DNS regexp entry.

test_dns_queryC

Tests a DNS query.

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

export_dns_configC

Exports DNS configuration to a file.

create_address_list_entryA

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.

list_address_list_entriesA

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.

get_address_list_entryC

Gets one address list entry by list name and address.

update_address_list_entryA

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.

remove_address_list_entryB

Removes an address list entry by list name and address.

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

enable_address_list_entryD

Enables an address list entry.

disable_address_list_entryD

Disables an address list entry.

create_filter_ruleC

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

list_filter_rulesC

Lists firewall filter rules on the MikroTik device.

get_filter_ruleA

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")

update_filter_ruleA

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="").

remove_filter_ruleB

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")

move_filter_ruleA

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

enable_filter_ruleC

Enables a firewall filter rule.

disable_filter_ruleC

Disables a firewall filter rule.

create_basic_firewall_setupC

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

create_ipv6_filter_ruleC

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".

list_ipv6_filter_rulesA

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.

get_ipv6_filter_ruleB

Gets detailed information about a specific IPv6 firewall filter rule.

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

update_ipv6_filter_ruleC

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="").

remove_ipv6_filter_ruleC

Removes an IPv6 firewall filter rule from the MikroTik device.

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

move_ipv6_filter_ruleB

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

enable_ipv6_filter_ruleC

Enables an IPv6 firewall filter rule.

disable_ipv6_filter_ruleB

Disables an IPv6 firewall filter rule.

list_ipv6_raw_rulesA

Lists /ipv6 firewall raw rules on the MikroTik device.

Notes: chain_filter, action_filter, protocol_filter: exact match. src/dst_address_filter, interface_filter (interfaces and interface lists), comment_filter: substring match. stats=True shows byte/packet counters.

get_ipv6_raw_ruleA

Gets detailed information about a specific /ipv6 firewall raw rule.

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

create_ipv6_raw_ruleA

Creates an /ipv6 firewall raw rule (applied before connection tracking).

Notes: chain: "prerouting" or "output", or a custom chain reached by jump. jump_target: required with action="jump". address_list (+ optional address_list_timeout, e.g. "1d"): required with add-src/dst-to-address-list. Prefix a matcher value with "!" to negate it. protocol: IPv6 uses "icmpv6", not "icmp". place_before: internal id ("*3") or print position ("0").

update_ipv6_raw_ruleB

Updates an existing /ipv6 firewall raw rule.

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

remove_ipv6_raw_ruleB

Removes an /ipv6 firewall raw rule.

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

move_ipv6_raw_ruleB

Moves an /ipv6 firewall raw rule to a different position.

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

enable_ipv6_raw_ruleC

Enables an /ipv6 firewall raw rule.

disable_ipv6_raw_ruleC

Disables an /ipv6 firewall raw rule.

create_nat_ruleC

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"

list_nat_rulesB

Lists NAT rules on the MikroTik device.

get_nat_ruleA

Gets detailed information about a specific NAT rule.

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

update_nat_ruleB

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.

remove_nat_ruleB

Removes a NAT rule from the MikroTik device.

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

move_nat_ruleB

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

enable_nat_ruleC

Enables a NAT rule.

disable_nat_ruleC

Disables a NAT rule.

list_raw_rulesA

Lists /ip firewall raw rules on the MikroTik device.

Notes: chain_filter, action_filter, protocol_filter: exact match. src/dst_address_filter, interface_filter (interfaces and interface lists), comment_filter: substring match. stats=True shows byte/packet counters.

get_raw_ruleA

Gets detailed information about a specific /ip firewall raw rule.

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

create_raw_ruleB

Creates an /ip firewall raw rule (applied before connection tracking).

Notes: chain: "prerouting" or "output", or a custom chain reached by jump. jump_target: required with action="jump". address_list (+ optional address_list_timeout, e.g. "1d"): required with add-src/dst-to-address-list. Prefix a matcher value with "!" to negate it. place_before: internal id ("*3") or print position ("0").

update_raw_ruleB

Updates an existing /ip firewall raw rule.

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

remove_raw_ruleB

Removes an /ip firewall raw rule.

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

move_raw_ruleB

Moves an /ip firewall raw rule to a different position.

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

enable_raw_ruleC

Enables an /ip firewall raw rule.

disable_raw_ruleC

Disables an /ip firewall raw rule.

list_bridge_vlansB

Lists bridge VLAN table entries (tagged/untagged port membership per VLAN).

add_bridge_vlanB

Adds an entry to the bridge VLAN table defining tagged/untagged port membership.

Notes: vlan_ids: single ID, comma list, or range e.g. "10", "10,20", "100-199" tagged: comma-separated ports carrying these VLANs tagged e.g. "ether1,ether2" untagged: comma-separated ports carrying these VLANs untagged

update_bridge_vlanA

Updates an existing bridge VLAN table entry.

Notes: vlan_ids: must match the stored value exactly (it is a list property) e.g. an entry created with "100-199" is matched by "100-199", not "150" tagged/untagged: comma-separated port lists; pass "" to clear the list Dynamic (D-flag) entries auto-created from PVIDs cannot be updated. A change is confirmed on the device before success is reported.

remove_bridge_vlanC

Removes an entry from the bridge VLAN table.

Notes: vlan_ids: must match the stored value exactly (it is a list property)

list_bridge_portsB

Lists bridge ports on the MikroTik device, including each port's PVID.

update_bridge_portA

Updates per-port VLAN settings (PVID, frame types, ingress filtering) on a bridge port.

Notes: interface: the port's interface name e.g. "ether2"; an interface can only belong to one bridge, so it uniquely identifies the bridge port pvid: VLAN ID assigned to untagged ingress traffic on this port A change is confirmed on the device before success is reported.

list_interfacesA

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 …

get_interfaceA

Gets detailed information about a specific interface by name.

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

enable_interfaceB

Enables an interface on the MikroTik device.

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

disable_interfaceC

Disables an interface on the MikroTik device.

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

get_poe_monitorA

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"

list_poeA

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 …

get_poe_settingsA

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"

create_vlan_interfaceC

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

list_vlan_interfacesA

Lists VLAN interfaces on the MikroTik device.

get_vlan_interfaceA

Gets detailed information about a specific VLAN interface.

update_vlan_interfaceC

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

remove_vlan_interfaceC

Removes a VLAN interface from the MikroTik device.

create_wireguard_interfaceC

Creates a WireGuard interface on the MikroTik device.

list_wireguard_interfacesC

Lists WireGuard interfaces on the MikroTik device.

get_wireguard_interfaceB

Gets detailed information about a specific WireGuard interface.

update_wireguard_interfaceC

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

remove_wireguard_interfaceC

Removes a WireGuard interface from the MikroTik device.

enable_wireguard_interfaceC

Enables a WireGuard interface.

disable_wireguard_interfaceC

Disables a WireGuard interface.

add_wireguard_peerA

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"

list_wireguard_peersB

Lists WireGuard peers on the MikroTik device.

get_wireguard_peerA

Gets detailed information about a specific WireGuard peer by ID.

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

update_wireguard_peerA

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.

remove_wireguard_peerB

Removes a WireGuard peer from the MikroTik device.

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

enable_wireguard_peerB

Enables a WireGuard peer.

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

disable_wireguard_peerC

Disables a WireGuard peer.

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

generate_wireguard_client_configA

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

create_wireless_interfaceC

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

list_wireless_interfacesC

Lists wireless interfaces on the MikroTik device.

get_wireless_interfaceC

Gets detailed information about a specific wireless interface.

remove_wireless_interfaceC

Removes a wireless interface from the MikroTik device.

enable_wireless_interfaceC

Enables a wireless interface.

disable_wireless_interfaceC

Disables a wireless interface.

scan_wireless_networksA

Scans for nearby wireless networks using the specified interface.

get_wireless_registration_tableB

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

check_wireless_supportA

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

create_wireless_security_profileC

Legacy function - not supported in RouterOS v7.x

list_wireless_security_profilesA

Legacy function - not supported in RouterOS v7.x

get_wireless_security_profileC

Legacy function - not supported in RouterOS v7.x

remove_wireless_security_profileC

Legacy function - not supported in RouterOS v7.x

set_wireless_security_profileC

Legacy function - not supported in RouterOS v7.x

create_wireless_access_listC

Legacy function - different in RouterOS v7.x

list_wireless_access_listD

Legacy function - different in RouterOS v7.x

remove_wireless_access_list_entryD

Legacy function - different in RouterOS v7.x

update_wireless_interfaceC

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

set_wireless_passphraseB

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.

add_ip_addressC

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

list_ip_addressesB

Lists IP addresses on the MikroTik device.

get_ip_addressB

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

remove_ip_addressC

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

add_ipv6_addressB

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.

list_ipv6_addressesA

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.

get_ipv6_addressA

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").

remove_ipv6_addressB

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

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

list_arp_entriesB

Lists detailed IPv4 ARP entries.

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

list_ipv6_neighborsA

Lists detailed IPv6 neighbor-discovery entries.

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

create_ip_poolC

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"

list_ip_poolsC

Lists IP pools on the MikroTik device.

get_ip_poolA

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

update_ip_poolB

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.

remove_ip_poolB

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

list_ip_pool_usedA

Lists currently used (allocated) addresses from IP pools.

expand_ip_poolA

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"

list_ip_servicesA

Lists the management services with their port and address restriction.

Notes: name_filter is a substring match (winbox, ssh, api, www, www-ssl, ftp, telnet). enabled_only=True hides the disabled ones, which is the list that actually describes exposure.

An empty `address` means unrestricted. Read that together with how the
device is reached: unrestricted on a router whose WAN holds a public
address means the service is published to the internet, whether or not
the port was changed from its default.

`ftp` deserves its own look: RouterOS also serves SFTP file transfers
through the SSH service to users whose group holds the `ftp` policy,
so the two are not the same control.
pingB

Pings an IPv4/IPv6 address or host name from the router (needs the "test" policy).

Notes: interval: e.g. "200ms" or "1s". arp_ping=True sends ARP requests instead of ICMP and needs interface. do_not_fragment with size finds the path MTU.

tracerouteB

Traces the route from the router to an IPv4/IPv6 address or host name (needs the "test" policy).

Notes: count: probes per hop; the run takes roughly count x hops x timeout at worst. timeout: per-probe timeout, e.g. "500ms" or "1s". port applies to protocol="udp".

torchA

Shows live traffic rates per flow on an interface for a few seconds (needs the "sniff" policy).

Notes: Each filter both filters and breaks the table down by that field: "0.0.0.0/0" (or "::/0") lists every address, "any" every protocol/port/VLAN/DSCP. With no filter, flows are broken down by IPv4 src/dst address and IP protocol. Torch turns off fasttrack while it runs (higher CPU). RouterOS prints its first frame after two seconds, so a duration under 3 runs for 3.

sniff_packetsA

Captures packet headers for a few seconds with the quick packet sniffer (needs the "sniff" policy).

Notes: Shows headers only (interface, direction, MACs, addresses, protocol, size); nothing is saved on the router. ip_address matches source or destination. port: "53", "80,443" or "1000-2000".

profile_cpuA

Shows which RouterOS processes use the CPU, sampled over a few seconds.

Notes: cpu: "total" (default), "all" for one column per core, or a core number (a duration under 3 runs for 3).

get_logsC

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

get_logs_by_severityB

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

get_logs_by_topicA

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

search_logsA

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

get_system_eventsB

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

get_security_logsA

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

clear_logsC

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

get_log_statisticsA

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

export_logsB

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

monitor_logsA

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

list_netwatchA

Lists the netwatch probes with their live status and measurements.

Configuration first, then a LIVE STATE block with status, since — the timestamp of the last transition — and, on an ICMP probe, the last test's numbers: rtt-avg, loss-percent, failed-tests. Match the two blocks by host, or by the .id the live one carries.

Notes: host_filter and comment_filter are substring matches; status_filter and type_filter are exact. Pass status_filter="down" to list only what is currently failing.

`include_source=False` (the default) omits `up-script`,
`down-script` and `test-script`, because a probe that alerts through a
webhook or an e-mail carries the token or the password inline. Set it
to True only when you intend to read those commands; the output is
redacted either way, but redaction is pattern-based and is not a
guarantee.

A probe with no `src-address` follows whichever WAN is active, so it
keeps reporting across a failover; one pinned to a source address
reports that path only. Which of the two you want depends on whether
you are watching the internet or a specific link.
create_queue_typeB

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"

list_queue_typesB

Lists queue types on the MikroTik device.

get_queue_typeC

Gets detailed information about a specific queue type.

update_queue_typeC

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

remove_queue_typeC

Removes a queue type from the MikroTik device.

create_queue_treeC

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)

list_queue_treesC

Lists queue trees on the MikroTik device.

get_queue_treeA

Gets detailed information about a specific queue tree.

update_queue_treeB

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)

remove_queue_treeC

Removes a queue tree from the MikroTik device.

enable_queue_treeD

Enables a queue tree.

disable_queue_treeC

Disables a queue tree.

create_simple_queueC

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)

list_simple_queuesB

Lists simple queues on the MikroTik device.

get_simple_queueA

Gets detailed information about a specific simple queue.

update_simple_queueA

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)

remove_simple_queueC

Removes a simple queue from the MikroTik device.

enable_simple_queueD

Enables a simple queue.

disable_simple_queueD

Disables a simple queue.

add_routeB

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)

list_routesC

Lists routes in MikroTik routing table.

get_routeA

Gets detailed information about a specific route.

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

update_routeB

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.

remove_routeB

Removes a route.

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

enable_routeC

Enables a route.

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

disable_routeC

Disables a route.

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

get_routing_tableC

Gets a specific routing table.

check_route_pathB

Checks the route MikroTik would use to reach a destination.

get_route_cacheC

Gets the route cache.

flush_route_cacheD

Flushes the route cache.

add_default_routeD

Adds a default route.

add_blackhole_routeC

Adds a blackhole route.

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

get_route_statisticsB

Gets routing table statistics.

create_backupC

Creates a system backup on the MikroTik device.

list_backupsC

Lists backup files on the MikroTik device.

create_exportC

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

export_sectionA

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)

download_fileA

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

upload_fileB

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

restore_backupC

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

import_configurationC

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

remove_fileC

Removes a file from the MikroTik device filesystem.

backup_infoA

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

get_system_resourceB

Reports uptime, RouterOS version, board name, architecture, CPU and memory.

Notes: free-memory against total-memory and cpu-load are the two numbers worth reading before blaming the network for a slow device. On the low-power boards a single packet-sniffing tool can saturate the CPU on its own.

get_system_healthB

Reports the board sensors: voltage, temperature, fan and PSU state.

Notes: Many boards carry no sensors at all and legitimately report nothing. An empty answer here means "this model does not measure it", not "the reading failed".

get_system_clockB

Reports the device clock, time zone and DST setting.

Notes: Log timestamps are only as trustworthy as this. A device without a working time source dates its own evidence wrongly, which matters when correlating an incident across sites.

get_system_routerboardB

Reports the model, serial number and bootloader firmware revision.

Notes: current-firmware against upgrade-firmware is the RouterBOOT bootloader, which is upgraded separately from RouterOS and is easy to leave behind after a package upgrade.

list_system_packagesB

Lists the installed RouterOS packages and which are disabled.

get_system_package_updateA

Reports the installed RouterOS version against the latest on its channel.

Notes: This reads the stored result of the last check; it does not contact MikroTik. latest-version can therefore be stale or empty on a device that has never checked or cannot reach the update server.

list_schedulersA

Lists the scheduled tasks with their interval, next run and run count.

Notes: name_filter is a substring match. Read next-run together with interval: a scheduler whose run-count is not advancing is firing into a script that errors out, which RouterOS does not surface here — it shows up in the log under the script topic.

`include_source=False` (the default) omits `on-event`, because a
scheduler can carry commands inline, and those routinely hold a bot
token or a password inside a URL. Redaction only recognises labelled
secrets, so withholding the field is what keeps them off the wire. Set
it to True only when you intend to read the commands; the output is
redacted either way, but redaction is pattern-based and is not a
guarantee.
list_scriptsA

Lists the stored scripts: owner, policy, run count and last start.

Notes: include_source=False (the default) omits the script body, because bodies routinely hold credentials in clear text. Set it to True only when you intend to read the code; the output is redacted either way, but redaction is pattern-based and is not a guarantee.

`policy` is what the script may do when it runs, which can exceed what
the user who scheduled it may do interactively.
add_userC

Adds a user to MikroTik device.

list_usersC

Lists users on MikroTik device.

get_userA

Gets detailed information about a specific user.

update_userD

Updates a user.

remove_userD

Removes a user.

disable_userC

Disables a user.

enable_userC

Enables a user.

add_user_groupD

Adds a user group.

list_user_groupsB

Lists user groups on MikroTik device.

get_user_groupA

Gets detailed information about a specific user group.

update_user_groupD

Updates a user group.

remove_user_groupC

Removes a user group.

get_active_usersB

Gets currently active/logged-in users.

disconnect_userC

Disconnects an active user session.

export_user_configC

Exports user configuration to a file.

set_user_ssh_keysC

Sets SSH keys for a specific user.

list_user_ssh_keysA

Lists SSH keys for a specific user.

remove_user_ssh_keyC

Removes an SSH key.

get_ipsec_installed_saA

Lists the installed IPsec security associations (child/phase 2 SAs).

The Flags legend is the point of this view. On RouterOS 7 it reads:

S - SEEN-TRAFFIC  the SA has carried packets
H - HW-AEAD       the cipher is running in hardware
E - ESP

S is the only field that separates an SA carrying traffic from one that is merely installed. A remote end reporting the connection as up, or its own byte counters growing, does not contradict a missing S: those count what the far side sent, not what arrived.

Two things this does NOT tell you, both easy to get wrong:

  • A missing S can mean idle, not broken. An SA nothing has used looks exactly like one that is failing, and RouterOS withholds addtime and expires-in until traffic appears, which makes it look half installed. Put traffic over the selector before concluding anything.

  • Per-SA counters do not map onto policies once a peer has several child SAs. Traffic picks among them, so one SA can carry the outbound side of two policies while another sits frozen at the counter it had minutes after install. Pairing SAs by hand — by install time, by address, by lifetime — invents a structure that is not there. Watch which counters move under traffic you control instead.

Notes: Address filters are substring matches on the SA endpoints, which are the tunnel endpoints (public addresses), not the encapsulated subnets. Behind NAT-T the endpoints carry the port (198.51.100.2:4500), which is why this is not an exact match: filtering on the bare address would find nothing there and report no SAs while some exist.

get_ipsec_active_peersA

Lists the IPsec peers with a live IKE session, with uptime and counters.

Shows the parent (phase 1) side: state, uptime, last-seen and the byte counters. A peer can sit here established while its child SAs carry nothing — use get_ipsec_installed_sa to tell the difference.

Notes: Both filters are exact matches.

list_ipsec_peersA

Lists the configured IPsec peers.

Notes: Filters are substring matches. Secrets live on /ip ipsec identity and are not exposed by any tool in this server.

list_ipsec_policiesA

Lists the IPsec policies, with their phase 2 state.

The Flags legend distinguishes configured policies from the ones a peer generated at runtime (D dynamic), and ph2-state says whether the child SA is established. A policy whose selectors do not match the far end's is the usual cause of a tunnel that comes up and passes nothing.

Notes: peer_filter is a substring match on the peer name; the address filters are substring matches on the policy selectors, which are the encapsulated subnets, not the tunnel endpoints.

list_ipsec_profilesA

Lists the IPsec profiles (phase 1 proposal: DH group, hash, lifetime, DPD).

Notes: lifetime here is phase 1. It must be LONGER than the phase 2 lifetime on /ip ipsec proposal, so the child SA rekeys inside a live parent SA; equal lifetimes tear the tunnel down on every rekey. dpd-interval multiplied by dpd-maximum-failures is how many seconds of silence the peer tolerates.

list_ipsec_proposalsB

Lists the IPsec proposals (phase 2: encryption, auth, PFS, lifetime).

Notes: Compare lifetime against the phase 1 lifetime on /ip ipsec profile, and against whatever the far end proposes — a cloud provider's own SA lifetime counts as a third value in that comparison.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

C2.6/5.0

Scored across 239 tools

Disambiguation4/5

Tools are organized into clearly named parallel families (filter/raw/nat, IPv4 vs IPv6, wireguard interface vs peer, simple queue vs queue tree), so an agent can generally tell them apart. The main ambiguity comes from the cluster of overlapping log tools (get_logs, get_logs_by_severity, get_logs_by_topic, search_logs, get_system_events, get_security_logs) and eight dead 'Legacy function - not supported in RouterOS v7.x' wireless tools that serve no purpose and add noise.

Naming Consistency4/5

The dominant pattern is a clean verb_noun scheme (list_x, get_x, create_x, update_x, remove_x, enable_x, disable_x, move_x) applied uniformly across firewall, DHCP, DNS, routes, queues, and WireGuard. The only real deviation is the inconsistent use of add_ vs create_ for creation (add_ip_address, add_route, add_user, add_wireguard_peer vs create_vlan_interface, create_dhcp_server, create_filter_rule), plus a few bare action names like ping, torch, traceroute.

Tool Count1/5

239 tools is an extreme mismatch for any single MCP surface; even a full RouterOS domain does not justify this many, and the set is bloated by eight explicitly unsupported legacy wireless tools and near-duplicate log tools. The breadth pushes far past the point where an agent can reliably select a tool.

Completeness3/5

Core object lifecycles (firewall filter/raw/NAT, address lists, DHCP server/pool/network, DNS, routes, queues, WireGuard, VLANs, bridge VLANs/ports, IP pools/addresses, users) are covered thoroughly with create/read/update/delete plus enable/disable. However, notable gaps remain: IPsec is read-only (peers, policies, proposals, profiles cannot be created or edited), scripts/schedulers/netwatch are list-only, and there is no bridge creation, DHCP client, PPP/PPPoE server, certificate, SNMP, or device reboot/upgrade tooling.

Maintenance

ActivityActive
ResponsivenessUsually handled