Skip to main content
Glama

Website Build Status Tests MIT License Discord MCP Toplist Audited by AddonAudit audited by mseep.ai

MikroTik MCP provides a bridge between AI assistants and MikroTik RouterOS devices. It allows AI assistants to interact with MikroTik routers through natural language requests, executing commands like managing VLANs, configuring firewall rules, handling DNS settings, and more.

Demo Videos

Claude Desktop

https://github.com/user-attachments/assets/24fadcdc-c6a8-48ed-90ac-74baf8f94b59

Inspector

https://github.com/user-attachments/assets/e0301ff2-8144-4503-83d0-48589d95027d

Inventory

NOTE

Since MikroTik MCP version0.14.0, the MikroTik MCP will allow you to manage multiple MikroTik devices within your fleet structure. The following video simply shows how to use the inventory of MikroTik devices to let LLMs talk with your MikroTik devices.

https://github.com/user-attachments/assets/185b2c39-8f55-4f26-a74c-2ac459ad38f5

Related MCP server: RouterOS MCP Server

Documentation

📚 Full Documentation - Complete guides, API reference, and examples

🌐 Prefer to read online? The same documentation is also published at www.mikrotik-mcp.com (docs) — an optional, web-friendly way to explore the project while reviewing the repo.

Contributors ❤️

MikroTik MCP is built by the people below. Thank you for every commit, issue, review and idea.

Contributions of every kind are welcome: code, bug reports, documentation and reviews all move the project forward. Start with the Contributing Guide.

Community

Got a question, an idea, or something you'd like to talk through? Join us on Discord. Users and contributors are both welcome, whether you're connecting your first router or working on a PR.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Presentations

Prefer to watch instead of read? The official MikroTik MCP presentations, including walkthroughs of new features and pull requests, live on Bisque: bisque.today/p/wiresage/mikrotik-mcp.

Available Tools

239 tools
add_blackhole_routeC

Adds a blackhole route.

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

Inputs: dst_address (required), device, comment, distance. Returns: result

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

Inputs: bridge (required), vlan_ids (required), device, tagged, +3 more. Returns: result

add_default_routeD

Adds a default route.

Inputs: gateway (required), device, comment, distance, +1 more. Returns: result

add_dns_regexpC

Adds a DNS regexp entry.

Inputs: regexp (required), address (required), ttl, device, +2 more. Returns: result

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

Inputs: name (required), ttl, text, cname, +11 more. Returns: result

add_ip_addressC

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

Inputs: address (required), interface (required), device, comment, +3 more. Returns: result

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.

Inputs: address (required), interface (required), device, eui_64, +5 more. Returns: result

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)

Inputs: gateway (required), dst_address (required), scope, device, +8 more. Returns: result

add_userC

Adds a user to MikroTik device.

Inputs: name (required), password (required), group, device, +3 more. Returns: result

add_user_groupD

Adds a user group.

Inputs: name (required), policy (required), skin, device, +1 more. Returns: result

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"

Inputs: interface (required), public_key (required), allowed_address (required), device, +6 more. Returns: result

backup_infoA
Read-onlyIdempotent

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

Inputs: filename (required), device. Returns: result

check_route_pathB
Read-onlyIdempotent

Checks the route MikroTik would use to reach a destination.

Inputs: destination (required), device. Returns: result

check_wireless_supportA
Read-onlyIdempotent

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

Inputs: device. Returns: result

clear_logsC
Read-onlyIdempotent

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

Inputs: device. Returns: result

commit_safe_modeA

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

Inputs: device. Returns: result

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.

Inputs: family (required), address (required), list_name (required), device, +3 more. Returns: result

create_backupC

Creates a system backup on the MikroTik device.

Inputs: name, device, comment, dont_encrypt, +1 more. Returns: result

create_basic_firewall_setupC
Destructive

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

Inputs: device. Returns: result

create_dhcp_networkC

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

Inputs: gateway (required), network (required), device, domain, +6 more. Returns: result

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"

Inputs: name (required), ranges (required), device, comment, +1 more. Returns: result

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"

Inputs: name (required), interface (required), device, comment, +5 more. Returns: result

create_exportC

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

Inputs: name, device, comment, compact, +4 more. Returns: result

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

Inputs: chain (required), action (required), log, limit, +19 more. Returns: result

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"

Inputs: name (required), ranges (required), device, comment, +1 more. Returns: result

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

Inputs: chain (required), action (required), log, limit, +22 more. Returns: result

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

Inputs: chain (required), action (required), log, dscp, +27 more. Returns: result

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"

Inputs: chain (required), action (required), log, device, +13 more. Returns: result

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)

Inputs: name (required), parent (required), queue, device, +10 more. Returns: result

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"

Inputs: name (required), kind, device, cake_mpu, +24 more. Returns: result

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

Inputs: chain (required), action (required), log, ttl, +27 more. Returns: result

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)

Inputs: name (required), target (required), dst, queue, +12 more. Returns: result

create_vlan_interfaceC

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

Inputs: name (required), vlan_id (required), interface (required), arp, +6 more. Returns: result

create_wireguard_interfaceC

Creates a WireGuard interface on the MikroTik device.

Inputs: name (required), mtu, device, comment, +3 more. Returns: result

create_wireless_access_listC

Legacy function - different in RouterOS v7.x

Inputs: device. Returns: result

create_wireless_interfaceC

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

Inputs: name (required), band, mode, ssid, +7 more. Returns: result

create_wireless_security_profileC

Legacy function - not supported in RouterOS v7.x

Inputs: name (required), device. Returns: result

disable_address_list_entryD
Idempotent

Disables an address list entry.

Inputs: family (required), address (required), list_name (required), device. Returns: result

disable_dns_staticC
Idempotent

Disables a static DNS entry.

Inputs: entry_id (required), device. Returns: result

disable_filter_ruleC
Idempotent

Disables a firewall filter rule.

Inputs: rule_id (required), device. Returns: result

disable_interfaceC
Idempotent

Disables an interface on the MikroTik device.

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

Inputs: name (required), device. Returns: result

disable_ipv6_filter_ruleB
Idempotent

Disables an IPv6 firewall filter rule.

Inputs: rule_id (required), device. Returns: result

disable_ipv6_raw_ruleC
Idempotent

Disables an /ipv6 firewall raw rule.

Inputs: rule_id (required), device. Returns: result

disable_nat_ruleC
Idempotent

Disables a NAT rule.

Inputs: rule_id (required), device. Returns: result

disable_queue_treeC
Idempotent

Disables a queue tree.

Inputs: name (required), device. Returns: result

disable_raw_ruleC
Idempotent

Disables an /ip firewall raw rule.

Inputs: rule_id (required), device. Returns: result

disable_routeC
Idempotent

Disables a route.

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

Inputs: route_id (required), device. Returns: result

disable_simple_queueD
Idempotent

Disables a simple queue.

Inputs: name (required), device. Returns: result

disable_userC
Idempotent

Disables a user.

Inputs: name (required), device. Returns: result

disable_wireguard_interfaceC
Idempotent

Disables a WireGuard interface.

Inputs: name (required), device. Returns: result

disable_wireguard_peerC
Idempotent

Disables a WireGuard peer.

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

Inputs: peer_id (required), device. Returns: result

disable_wireless_interfaceC
Idempotent

Disables a wireless interface.

Inputs: name (required), device. Returns: result

disconnect_userC
DestructiveIdempotent

Disconnects an active user session.

Inputs: user_id (required), device. Returns: result

download_fileA
Read-onlyIdempotent

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

Inputs: filename (required), device, file_type. Returns: result

enable_address_list_entryD
Idempotent

Enables an address list entry.

Inputs: family (required), address (required), list_name (required), device. Returns: result

enable_dns_staticC
Idempotent

Enables a static DNS entry.

Inputs: entry_id (required), device. Returns: result

enable_filter_ruleC
Idempotent

Enables a firewall filter rule.

Inputs: rule_id (required), device. Returns: result

enable_interfaceB
Idempotent

Enables an interface on the MikroTik device.

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

Inputs: name (required), device. Returns: result

enable_ipv6_filter_ruleC
Idempotent

Enables an IPv6 firewall filter rule.

Inputs: rule_id (required), device. Returns: result

enable_ipv6_raw_ruleC
Idempotent

Enables an /ipv6 firewall raw rule.

Inputs: rule_id (required), device. Returns: result

enable_nat_ruleC
Idempotent

Enables a NAT rule.

Inputs: rule_id (required), device. Returns: result

enable_queue_treeD
Idempotent

Enables a queue tree.

Inputs: name (required), device. Returns: result

enable_raw_ruleC
Idempotent

Enables an /ip firewall raw rule.

Inputs: rule_id (required), device. Returns: result

enable_routeC
Idempotent

Enables a route.

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

Inputs: route_id (required), device. Returns: result

enable_safe_modeA

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

Inputs: device. Returns: result

enable_simple_queueD
Idempotent

Enables a simple queue.

Inputs: name (required), device. Returns: result

enable_userC
Idempotent

Enables a user.

Inputs: name (required), device. Returns: result

enable_wireguard_interfaceC
Idempotent

Enables a WireGuard interface.

Inputs: name (required), device. Returns: result

enable_wireguard_peerB
Idempotent

Enables a WireGuard peer.

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

Inputs: peer_id (required), device. Returns: result

enable_wireless_interfaceC
Idempotent

Enables a wireless interface.

Inputs: name (required), device. Returns: result

expand_ip_poolA
Idempotent

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"

Inputs: name (required), additional_ranges (required), device. Returns: result

export_dns_configC

Exports DNS configuration to a file.

Inputs: device, filename. Returns: result

export_logsB

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

Inputs: device, topics, filename, time_filter. Returns: result

export_sectionA
Read-onlyIdempotent

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)

Inputs: section (required), device, compact, hide_sensitive. Returns: result

export_user_configC

Exports user configuration to a file.

Inputs: device, filename. Returns: result

flush_dns_cacheC
DestructiveIdempotent

Flushes the DNS cache.

Inputs: device. Returns: result

flush_route_cacheD
DestructiveIdempotent

Flushes the route cache.

Inputs: device. Returns: result

generate_wireguard_client_configA
Read-onlyIdempotent

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

Inputs: client_address (required), server_endpoint (required), server_public_key (required), client_private_key (required), +5 mo… Returns: result

get_active_usersB
Read-onlyIdempotent

Gets currently active/logged-in users.

Inputs: device. Returns: result

get_address_list_entryC
Read-onlyIdempotent

Gets one address list entry by list name and address.

Inputs: family (required), address (required), list_name (required), device. Returns: result

get_dhcp_serverB
Read-onlyIdempotent

Gets detailed information about a specific DHCP server.

Inputs: name (required), device. Returns: result

get_dns_cacheB
Read-onlyIdempotent

Gets the current DNS cache.

Inputs: device. Returns: result

get_dns_cache_statisticsC
Read-onlyIdempotent

Gets DNS cache statistics.

Inputs: device. Returns: result

get_dns_settingsC
Read-onlyIdempotent

Gets current DNS configuration.

Inputs: device. Returns: result

get_dns_staticA
Read-onlyIdempotent

Gets details of a specific static DNS entry.

Inputs: entry_id (required), device. Returns: result

get_filter_ruleA
Read-onlyIdempotent

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

Inputs: rule_id (required), device. Returns: result

get_interfaceA
Read-onlyIdempotent

Gets detailed information about a specific interface by name.

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

Inputs: name (required), device. Returns: result

get_ip_addressB
Read-onlyIdempotent

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

Inputs: address_id (required), device. Returns: result

get_ip_poolA
Read-onlyIdempotent

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

Inputs: name (required), device. Returns: result

get_ipsec_active_peersA
Read-onlyIdempotent

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.

Inputs: device, state_filter, remote_address_filter. Returns: result

get_ipsec_installed_saA
Read-onlyIdempotent

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.

Inputs: device, dst_address_filter, src_address_filter. Returns: result

get_ipv6_addressA
Read-onlyIdempotent

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

Inputs: address_id (required), device. Returns: result

get_ipv6_filter_ruleB
Read-onlyIdempotent

Gets detailed information about a specific IPv6 firewall filter rule.

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

Inputs: rule_id (required), device. Returns: result

get_ipv6_raw_ruleA
Read-onlyIdempotent

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

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

Inputs: rule_id (required), device. Returns: result

get_logsC
Read-onlyIdempotent

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

Inputs: limit, device, topics, print_as, +3 more. Returns: result

get_logs_by_severityB
Read-onlyIdempotent

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

Inputs: severity (required), limit, device, time_filter. Returns: result

get_logs_by_topicA
Read-onlyIdempotent

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

Inputs: topic (required), limit, device, time_filter. Returns: result

get_log_statisticsA
Read-onlyIdempotent

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

Inputs: device. Returns: result

get_nat_ruleA
Read-onlyIdempotent

Gets detailed information about a specific NAT rule.

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

Inputs: rule_id (required), device. Returns: result

get_poe_monitorA
Read-onlyIdempotent

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"

Inputs: interfaces (required), device. Returns: result

get_poe_settingsA
Read-onlyIdempotent

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"

Inputs: name (required), device. Returns: result

get_queue_treeA
Read-onlyIdempotent

Gets detailed information about a specific queue tree.

Inputs: name (required), device. Returns: result

get_queue_typeC
Read-onlyIdempotent

Gets detailed information about a specific queue type.

Inputs: name (required), device. Returns: result

get_raw_ruleA
Read-onlyIdempotent

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

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

Inputs: rule_id (required), device. Returns: result

get_routeA
Read-onlyIdempotent

Gets detailed information about a specific route.

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

Inputs: route_id (required), device. Returns: result

get_route_cacheC
Read-onlyIdempotent

Gets the route cache.

Inputs: device. Returns: result

get_route_statisticsB
Read-onlyIdempotent

Gets routing table statistics.

Inputs: device. Returns: result

get_routing_tableC
Read-onlyIdempotent

Gets a specific routing table.

Inputs: device, table_name, active_only, protocol_filter. Returns: result

get_security_logsA
Read-onlyIdempotent

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

Inputs: limit, device, time_filter. Returns: result

get_simple_queueA
Read-onlyIdempotent

Gets detailed information about a specific simple queue.

Inputs: name (required), device. Returns: result

get_system_clockB
Read-onlyIdempotent

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.

Inputs: device. Returns: result

get_system_eventsB
Read-onlyIdempotent

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

Inputs: limit, device, event_type, time_filter. Returns: result

get_system_healthB
Read-onlyIdempotent

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

Inputs: device. Returns: result

get_system_package_updateA
Read-onlyIdempotent

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.

Inputs: device. Returns: result

get_system_resourceB
Read-onlyIdempotent

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.

Inputs: device. Returns: result

get_system_routerboardB
Read-onlyIdempotent

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.

Inputs: device. Returns: result

get_userA
Read-onlyIdempotent

Gets detailed information about a specific user.

Inputs: name (required), device. Returns: result

get_user_groupA
Read-onlyIdempotent

Gets detailed information about a specific user group.

Inputs: name (required), device. Returns: result

get_vlan_interfaceA
Read-onlyIdempotent

Gets detailed information about a specific VLAN interface.

Inputs: name (required), device. Returns: result

get_wireguard_interfaceB
Read-onlyIdempotent

Gets detailed information about a specific WireGuard interface.

Inputs: name (required), device. Returns: result

get_wireguard_peerA
Read-onlyIdempotent

Gets detailed information about a specific WireGuard peer by ID.

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

Inputs: peer_id (required), device. Returns: result

get_wireless_interfaceC
Read-onlyIdempotent

Gets detailed information about a specific wireless interface.

Inputs: name (required), device. Returns: result

get_wireless_registration_tableB
Read-onlyIdempotent

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

Inputs: device, interface. Returns: result

get_wireless_security_profileC
Read-onlyIdempotent

Legacy function - not supported in RouterOS v7.x

Inputs: name (required), device. Returns: result

import_configurationC
Destructive

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

Inputs: filename (required), device, verbose, run_after_reset. Returns: result

list_address_list_entriesA
Read-onlyIdempotent

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.

Inputs: family (required), device, list_filter, static_only, +4 more. Returns: result

list_arp_entriesB
Read-onlyIdempotent

Lists detailed IPv4 ARP entries.

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

Inputs: device, mac_filter, status_filter, address_filter, +1 more. Returns: result

list_backupsC
Read-onlyIdempotent

Lists backup files on the MikroTik device.

Inputs: device, name_filter, include_exports. Returns: result

list_bridge_portsB
Read-onlyIdempotent

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

Inputs: device, bridge_filter, interface_filter. Returns: result

list_bridge_vlansB
Read-onlyIdempotent

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

Inputs: device, dynamic_only, bridge_filter, vlan_ids_filter. Returns: result

list_devicesA
Read-onlyIdempotent

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.

Inputs: no named parameters. Returns: result

list_dhcp_leasesA
Read-onlyIdempotent

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.

Inputs: device, mac_filter, server_filter, status_filter, +6 more. Returns: result

list_dhcp_serversB
Read-onlyIdempotent

Lists DHCP servers on the MikroTik device.

Inputs: device, name_filter, invalid_only, disabled_only, +1 more. Returns: result

list_dhcpv6_bindingsA
Read-onlyIdempotent

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.

Inputs: device, duid_filter, iaid_filter, server_filter, +4 more. Returns: result

list_dns_staticB
Read-onlyIdempotent

Lists static DNS entries.

Inputs: device, name_filter, regexp_only, type_filter, +2 more. Returns: result

list_filter_rulesC
Read-onlyIdempotent

Lists firewall filter rules on the MikroTik device.

Inputs: device, chain_filter, dynamic_only, invalid_only, +6 more. Returns: result

list_interfacesA
Read-onlyIdempotent

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 …

Inputs: device, name_filter, type_filter, running_only, +1 more. Returns: result

list_ip_addressesB
Read-onlyIdempotent

Lists IP addresses on the MikroTik device.

Inputs: device, dynamic_only, disabled_only, address_filter, +2 more. Returns: result

list_ip_poolsC
Read-onlyIdempotent

Lists IP pools on the MikroTik device.

Inputs: device, name_filter, include_used, ranges_filter. Returns: result

list_ip_pool_usedA
Read-onlyIdempotent

Lists currently used (allocated) addresses from IP pools.

Inputs: device, pool_name, mac_filter, info_filter, +1 more. Returns: result

list_ipsec_peersA
Read-onlyIdempotent

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.

Inputs: device, name_filter, address_filter. Returns: result

list_ipsec_policiesA
Read-onlyIdempotent

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.

Inputs: device, peer_filter, dst_address_filter, src_address_filter. Returns: result

list_ipsec_profilesA
Read-onlyIdempotent

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.

Inputs: device, name_filter. Returns: result

list_ipsec_proposalsB
Read-onlyIdempotent

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.

Inputs: device, name_filter. Returns: result

list_ip_servicesA
Read-onlyIdempotent

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.

Inputs: device, name_filter, enabled_only. Returns: result

list_ipv6_addressesA
Read-onlyIdempotent

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.

Inputs: device, global_only, dynamic_only, disabled_only, +3 more. Returns: result

list_ipv6_filter_rulesA
Read-onlyIdempotent

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.

Inputs: device, chain_filter, dynamic_only, invalid_only, +6 more. Returns: result

list_ipv6_neighborsA
Read-onlyIdempotent

Lists detailed IPv6 neighbor-discovery entries.

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

Inputs: device, mac_filter, status_filter, address_filter, +1 more. Returns: result

list_ipv6_raw_rulesA
Read-onlyIdempotent

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.

Inputs: stats, device, chain_filter, dynamic_only, +8 more. Returns: result

list_nat_rulesB
Read-onlyIdempotent

Lists NAT rules on the MikroTik device.

Inputs: device, chain_filter, invalid_only, action_filter, +5 more. Returns: result

list_netwatchA
Read-onlyIdempotent

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.

Inputs: device, host_filter, type_filter, status_filter, +2 more. Returns: result

list_poeA
Read-onlyIdempotent

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 …

Inputs: device, interface_filter. Returns: result

list_queue_treesC
Read-onlyIdempotent

Lists queue trees on the MikroTik device.

Inputs: device, name_filter, invalid_only, disabled_only, +1 more. Returns: result

list_queue_typesB
Read-onlyIdempotent

Lists queue types on the MikroTik device.

Inputs: device, kind_filter, name_filter. Returns: result

list_raw_rulesA
Read-onlyIdempotent

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.

Inputs: stats, device, chain_filter, dynamic_only, +8 more. Returns: result

list_routesC
Read-onlyIdempotent

Lists routes in MikroTik routing table.

Inputs: device, dst_filter, active_only, static_only, +5 more. Returns: result

list_schedulersA
Read-onlyIdempotent

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.

Inputs: device, name_filter, include_source. Returns: result

list_scriptsA
Read-onlyIdempotent

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.

Inputs: device, name_filter, include_source. Returns: result

list_simple_queuesB
Read-onlyIdempotent

Lists simple queues on the MikroTik device.

Inputs: device, name_filter, invalid_only, disabled_only, +1 more. Returns: result

list_system_packagesB
Read-onlyIdempotent

Lists the installed RouterOS packages and which are disabled.

Inputs: device. Returns: result

list_user_groupsB
Read-onlyIdempotent

Lists user groups on MikroTik device.

Inputs: device, name_filter, policy_filter. Returns: result

list_usersC
Read-onlyIdempotent

Lists users on MikroTik device.

Inputs: device, active_only, name_filter, group_filter, +1 more. Returns: result

list_user_ssh_keysA
Read-onlyIdempotent

Lists SSH keys for a specific user.

Inputs: username (required), device. Returns: result

list_vlan_interfacesA
Read-onlyIdempotent

Lists VLAN interfaces on the MikroTik device.

Inputs: device, name_filter, disabled_only, vlan_id_filter, +1 more. Returns: result

list_wireguard_interfacesC
Read-onlyIdempotent

Lists WireGuard interfaces on the MikroTik device.

Inputs: device, name_filter, running_only, disabled_only. Returns: result

list_wireguard_peersB
Read-onlyIdempotent

Lists WireGuard peers on the MikroTik device.

Inputs: device, disabled_only, interface_filter. Returns: result

list_wireless_access_listD
Read-onlyIdempotent

Legacy function - different in RouterOS v7.x

Inputs: device. Returns: result

list_wireless_interfacesC
Read-onlyIdempotent

Lists wireless interfaces on the MikroTik device.

Inputs: device, name_filter, running_only, disabled_only. Returns: result

list_wireless_security_profilesA
Read-onlyIdempotent

Legacy function - not supported in RouterOS v7.x

Inputs: device. Returns: result

monitor_logsA
Read-onlyIdempotent

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

Inputs: device, topics, duration. Returns: result

move_filter_ruleA
Idempotent

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

Inputs: rule_id (required), destination (required), device. Returns: result

move_ipv6_filter_ruleB
Idempotent

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

Inputs: rule_id (required), destination (required), device. Returns: result

move_ipv6_raw_ruleB
Idempotent

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.

Inputs: rule_id (required), destination (required), device. Returns: result

move_nat_ruleB
Idempotent

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

Inputs: rule_id (required), destination (required), device. Returns: result

move_raw_ruleB
Idempotent

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.

Inputs: rule_id (required), destination (required), device. Returns: result

pingB
Read-only

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.

Inputs: address (required), ttl, size, count, +7 more. Returns: result

profile_cpuA
Read-onlyIdempotent

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

Inputs: cpu, device, duration. Returns: result

remove_address_list_entryB
DestructiveIdempotent

Removes an address list entry by list name and address.

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

Inputs: family (required), address (required), list_name (required), device. Returns: result

remove_bridge_vlanC
DestructiveIdempotent

Removes an entry from the bridge VLAN table.

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

Inputs: bridge (required), vlan_ids (required), device. Returns: result

remove_dhcp_networkC
DestructiveIdempotent

Removes a DHCP network configuration from the MikroTik device.

Inputs: network (required), device. Returns: result

remove_dhcp_serverC
DestructiveIdempotent

Removes a DHCP server from the MikroTik device.

Inputs: name (required), device. Returns: result

remove_dns_staticC
DestructiveIdempotent

Removes a static DNS entry.

Inputs: entry_id (required), device. Returns: result

remove_fileC
Destructive

Removes a file from the MikroTik device filesystem.

Inputs: filename (required), device. Returns: result

remove_filter_ruleB
DestructiveIdempotent

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

Inputs: rule_id (required), device. Returns: result

remove_ip_addressC
DestructiveIdempotent

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

Inputs: address_id (required), device. Returns: result

remove_ip_poolB
DestructiveIdempotent

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

Inputs: name (required), device. Returns: result

remove_ipv6_addressB
DestructiveIdempotent

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

Inputs: address_id (required), device. Returns: result

remove_ipv6_filter_ruleC
DestructiveIdempotent

Removes an IPv6 firewall filter rule from the MikroTik device.

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

Inputs: rule_id (required), device. Returns: result

remove_ipv6_raw_ruleB
DestructiveIdempotent

Removes an /ipv6 firewall raw rule.

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

Inputs: rule_id (required), device. Returns: result

remove_nat_ruleB
DestructiveIdempotent

Removes a NAT rule from the MikroTik device.

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

Inputs: rule_id (required), device. Returns: result

remove_queue_treeC
DestructiveIdempotent

Removes a queue tree from the MikroTik device.

Inputs: name (required), device. Returns: result

remove_queue_typeC
DestructiveIdempotent

Removes a queue type from the MikroTik device.

Inputs: name (required), device. Returns: result

remove_raw_ruleB
DestructiveIdempotent

Removes an /ip firewall raw rule.

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

Inputs: rule_id (required), device. Returns: result

remove_routeB
DestructiveIdempotent

Removes a route.

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

Inputs: route_id (required), device. Returns: result

remove_simple_queueC
DestructiveIdempotent

Removes a simple queue from the MikroTik device.

Inputs: name (required), device. Returns: result

remove_userD
DestructiveIdempotent

Removes a user.

Inputs: name (required), device. Returns: result

remove_user_groupC
DestructiveIdempotent

Removes a user group.

Inputs: name (required), device. Returns: result

remove_user_ssh_keyC
DestructiveIdempotent

Removes an SSH key.

Inputs: key_id (required), device. Returns: result

remove_vlan_interfaceC
DestructiveIdempotent

Removes a VLAN interface from the MikroTik device.

Inputs: name (required), device. Returns: result

remove_wireguard_interfaceC
DestructiveIdempotent

Removes a WireGuard interface from the MikroTik device.

Inputs: name (required), device. Returns: result

remove_wireguard_peerB
DestructiveIdempotent

Removes a WireGuard peer from the MikroTik device.

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

Inputs: peer_id (required), device. Returns: result

remove_wireless_access_list_entryD
DestructiveIdempotent

Legacy function - different in RouterOS v7.x

Inputs: entry_id (required), device. Returns: result

remove_wireless_interfaceC
DestructiveIdempotent

Removes a wireless interface from the MikroTik device.

Inputs: name (required), device. Returns: result

remove_wireless_security_profileC
DestructiveIdempotent

Legacy function - not supported in RouterOS v7.x

Inputs: name (required), device. Returns: result

restore_backupC
Destructive

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

Inputs: filename (required), device, password. Returns: result

rollback_safe_modeA
DestructiveIdempotent

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

Inputs: device. Returns: result

safe_mode_statusA
Read-onlyIdempotent

Returns whether MikroTik Safe Mode is currently active.

Inputs: device. Returns: result

scan_wireless_networksA
Read-onlyIdempotent

Scans for nearby wireless networks using the specified interface.

Inputs: interface (required), device, duration. Returns: result

search_logsA
Read-onlyIdempotent

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

Inputs: search_term (required), limit, device, time_filter, +1 more. Returns: result

set_dns_serversC

Sets DNS server configuration.

Inputs: servers (required), device, use_doh, cache_size, +6 more. Returns: result

set_user_ssh_keysC

Sets SSH keys for a specific user.

Inputs: key_file (required), username (required), device. Returns: result

set_wireless_passphraseB
Idempotent

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.

Inputs: name (required), passphrase (required), device, authentication_types. Returns: result

set_wireless_security_profileC

Legacy function - not supported in RouterOS v7.x

Inputs: interface_name (required), security_profile (required), device. Returns: result

sniff_packetsA
Read-only

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

Inputs: port, device, duration, interface, +3 more. Returns: result

test_dns_queryC
Read-onlyIdempotent

Tests a DNS query.

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

Inputs: name (required), type, device, server. Returns: result

torchA
Read-only

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.

Inputs: interface (required), dscp, port, device, +8 more. Returns: result

tracerouteB
Read-only

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

Inputs: address (required), port, size, count, +8 more. Returns: result

update_address_list_entryA
Idempotent

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.

Inputs: family (required), address (required), list_name (required), device, +4 more. Returns: result

update_bridge_portA
Idempotent

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.

Inputs: interface (required), pvid, device, frame_types, +1 more. Returns: result

update_bridge_vlanA
Idempotent

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.

Inputs: bridge (required), vlan_ids (required), device, tagged, +4 more. Returns: result

update_dhcp_networkB
Idempotent

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.

Inputs: network (required), device, domain, comment, +6 more. Returns: result

update_dns_staticD
Idempotent

Updates a static DNS entry.

Inputs: entry_id (required), ttl, name, text, +12 more. Returns: result

update_filter_ruleA
Idempotent

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

Inputs: rule_id (required), log, chain, limit, +19 more. Returns: result

update_ip_poolB
Idempotent

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.

Inputs: name (required), device, ranges, comment, +2 more. Returns: result

update_ipv6_filter_ruleC
Idempotent

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

Inputs: rule_id (required), log, chain, limit, +22 more. Returns: result

update_ipv6_raw_ruleB
Idempotent

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

Inputs: rule_id (required), log, dscp, port, +27 more. Returns: result

update_nat_ruleB
Idempotent

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.

Inputs: rule_id (required), log, chain, action, +13 more. Returns: result

update_queue_treeB
Idempotent

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)

Inputs: name (required), queue, device, parent, +11 more. Returns: result

update_queue_typeC
Idempotent

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

Inputs: name (required), device, cake_mpu, cake_nat, +11 more. Returns: result

update_raw_ruleB
Idempotent

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

Inputs: rule_id (required), log, ttl, dscp, +27 more. Returns: result

update_routeB
Idempotent

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.

Inputs: route_id (required), scope, device, comment, +9 more. Returns: result

update_simple_queueA
Idempotent

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)

Inputs: name (required), dst, queue, device, +13 more. Returns: result

update_userD
Idempotent

Updates a user.

Inputs: name (required), group, device, address, +4 more. Returns: result

update_user_groupD
Idempotent

Updates a user group.

Inputs: name (required), skin, device, policy, +2 more. Returns: result

update_vlan_interfaceC
Idempotent

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

Inputs: name (required), arp, mtu, device, +7 more. Returns: result

update_wireguard_interfaceC
Idempotent

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

Inputs: name (required), mtu, device, comment, +4 more. Returns: result

update_wireguard_peerA
Idempotent

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.

Inputs: peer_id (required), device, comment, disabled, +5 more. Returns: result

update_wireless_interfaceC
Idempotent

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

Inputs: name (required), ssid, device, comment, +2 more. Returns: result

upload_fileB

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

Inputs: filename (required), content_base64 (required), device. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A bridge between AI assistants and MikroTik RouterOS devices, allowing natural language interaction to manage network configurations including VLANs, firewalls, DNS settings, and more.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with MikroTik RouterOS devices through API and SSH connections, supporting network monitoring, configuration management, and diagnostics across multiple routers with automatic connection fallback.
      3
      MIT