MikroTik MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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 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 |
| 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 |
| 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 |
| 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 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 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 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 |
| 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:
|
| 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 Notes:
|
| 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:
|
| 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:
|
| 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. |
| list_schedulersA | Lists the scheduled tasks with their interval, next run and run count. Notes:
|
| list_scriptsA | Lists the stored scripts: owner, policy, run count and last start. Notes:
|
| 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:
Two things this does NOT tell you, both easy to get wrong:
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 ( |
| get_ipsec_active_peersA | Lists the IPsec peers with a live IKE session, with uptime and counters. Shows the parent (phase 1) side: Notes: Both filters are exact matches. |
| list_ipsec_peersA | Lists the configured IPsec peers. Notes:
Filters are substring matches. Secrets live on |
| 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 ( Notes:
|
| list_ipsec_profilesA | Lists the IPsec profiles (phase 1 proposal: DH group, hash, lifetime, DPD). Notes:
|
| list_ipsec_proposalsB | Lists the IPsec proposals (phase 2: encryption, auth, PFS, lifetime). Notes:
Compare |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 239 tools
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.
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.
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.
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.