MikroTik MCP
This MikroTik MCP server acts as an AI-driven bridge, allowing natural language management of MikroTik RouterOS devices. It offers comprehensive control over configuration, monitoring, and maintenance tasks across these areas:
Backup & Configuration: Create, list, and restore system backups; export full or specific configuration sections (RSC, JSON, XML); upload, download, import, and execute configuration scripts; manage filesystem files.
DHCP Management: Create, list, get, and remove DHCP servers; define DHCP networks (gateway, DNS, domain) and address pools.
DNS Management: Configure global DNS (including DoH); manage static DNS entries (add, list, get, update, remove, enable/disable); manage DNS regexp entries, cache (flush, stats), test queries, and export DNS config.
Firewall Management: Full lifecycle management of filter rules and NAT rules (srcnat/dstnat) – create, list, get, update, move, enable/disable, remove; apply a basic firewall setup automatically.
Interface Management: List, get details, enable, and disable any interface type (ethernet, bridge, VLAN, WireGuard, PPPoE, WiFi, LTE, etc.).
IP Address & Pool Management: Add, list, get, remove IPv4 and IPv6 addresses (with EUI-64, no-DAD, prefix advertisement options); create, list, get, update, remove, and expand IP pools; list used pool addresses.
Logging & Monitoring: Retrieve logs with filters (topic, severity, time, keyword), get system/security events, monitor in near-real-time, view statistics, clear logs, export logs.
QoS / Traffic Management: Manage queue types (CAKE, FQ-CoDel, SFQ, PCQ, RED, etc.), queue trees, and simple queues (create, list, get, update, remove, enable/disable) for advanced bandwidth control.
PoE Management: Monitor PoE status (voltage, current, power) and retrieve PoE configuration.
System: Check Safe Mode status.
Provides a bridge to interact with MikroTik RouterOS devices, enabling AI assistants to manage VLANs, configure firewall rules, handle DNS settings, and more via natural language requests.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MikroTik MCP add a firewall rule to block SSH from WAN"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
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.
Quick Links
Installation Guide - Get started with MikroTik MCP
API Coverage - Implemented and planned RouterOS features
Testing Guide - Run unit and integration tests
Claude Code Integration - Configure for Claude Code
Claude Desktop Integration - Configure for Claude Desktop
MCP Inspector - Interactive testing tool
Contributing Guide - Help improve MikroTik MCP
Articles - Learning resources and tutorials
Diagrams - Architecture and design diagrams (draw.io)
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 toolsadd_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_infoARead-onlyIdempotent
Gets detailed information about a backup file on the MikroTik device.
Inputs: filename (required), device. Returns: result
check_route_pathBRead-onlyIdempotent
Checks the route MikroTik would use to reach a destination.
Inputs: destination (required), device. Returns: result
check_wireless_supportARead-onlyIdempotent
Checks if the device supports wireless and reports the RouterOS version and wireless interface type.
Inputs: device. Returns: result
clear_logsCRead-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_setupCDestructive
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_entryDIdempotent
Disables an address list entry.
Inputs: family (required), address (required), list_name (required), device. Returns: result
disable_dns_staticCIdempotent
Disables a static DNS entry.
Inputs: entry_id (required), device. Returns: result
disable_filter_ruleCIdempotent
Disables a firewall filter rule.
Inputs: rule_id (required), device. Returns: result
disable_interfaceCIdempotent
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_ruleBIdempotent
Disables an IPv6 firewall filter rule.
Inputs: rule_id (required), device. Returns: result
disable_ipv6_raw_ruleCIdempotent
Disables an /ipv6 firewall raw rule.
Inputs: rule_id (required), device. Returns: result
disable_nat_ruleCIdempotent
Disables a NAT rule.
Inputs: rule_id (required), device. Returns: result
disable_queue_treeCIdempotent
Disables a queue tree.
Inputs: name (required), device. Returns: result
disable_raw_ruleCIdempotent
Disables an /ip firewall raw rule.
Inputs: rule_id (required), device. Returns: result
disable_routeCIdempotent
Disables a route.
Notes: route_id: "*N" or "N" from list output e.g. "*3"
Inputs: route_id (required), device. Returns: result
disable_simple_queueDIdempotent
Disables a simple queue.
Inputs: name (required), device. Returns: result
disable_userCIdempotent
Disables a user.
Inputs: name (required), device. Returns: result
disable_wireguard_interfaceCIdempotent
Disables a WireGuard interface.
Inputs: name (required), device. Returns: result
disable_wireguard_peerCIdempotent
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_interfaceCIdempotent
Disables a wireless interface.
Inputs: name (required), device. Returns: result
disconnect_userCDestructiveIdempotent
Disconnects an active user session.
Inputs: user_id (required), device. Returns: result
download_fileARead-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_entryDIdempotent
Enables an address list entry.
Inputs: family (required), address (required), list_name (required), device. Returns: result
enable_dns_staticCIdempotent
Enables a static DNS entry.
Inputs: entry_id (required), device. Returns: result
enable_filter_ruleCIdempotent
Enables a firewall filter rule.
Inputs: rule_id (required), device. Returns: result
enable_interfaceBIdempotent
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_ruleCIdempotent
Enables an IPv6 firewall filter rule.
Inputs: rule_id (required), device. Returns: result
enable_ipv6_raw_ruleCIdempotent
Enables an /ipv6 firewall raw rule.
Inputs: rule_id (required), device. Returns: result
enable_nat_ruleCIdempotent
Enables a NAT rule.
Inputs: rule_id (required), device. Returns: result
enable_queue_treeDIdempotent
Enables a queue tree.
Inputs: name (required), device. Returns: result
enable_raw_ruleCIdempotent
Enables an /ip firewall raw rule.
Inputs: rule_id (required), device. Returns: result
enable_routeCIdempotent
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_queueDIdempotent
Enables a simple queue.
Inputs: name (required), device. Returns: result
enable_userCIdempotent
Enables a user.
Inputs: name (required), device. Returns: result
enable_wireguard_interfaceCIdempotent
Enables a WireGuard interface.
Inputs: name (required), device. Returns: result
enable_wireguard_peerBIdempotent
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_interfaceCIdempotent
Enables a wireless interface.
Inputs: name (required), device. Returns: result
expand_ip_poolAIdempotent
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_sectionARead-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_cacheCDestructiveIdempotent
Flushes the DNS cache.
Inputs: device. Returns: result
flush_route_cacheDDestructiveIdempotent
Flushes the route cache.
Inputs: device. Returns: result
generate_wireguard_client_configARead-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_usersBRead-onlyIdempotent
Gets currently active/logged-in users.
Inputs: device. Returns: result
get_address_list_entryCRead-onlyIdempotent
Gets one address list entry by list name and address.
Inputs: family (required), address (required), list_name (required), device. Returns: result
get_dhcp_serverBRead-onlyIdempotent
Gets detailed information about a specific DHCP server.
Inputs: name (required), device. Returns: result
get_dns_cacheBRead-onlyIdempotent
Gets the current DNS cache.
Inputs: device. Returns: result
get_dns_cache_statisticsCRead-onlyIdempotent
Gets DNS cache statistics.
Inputs: device. Returns: result
get_dns_settingsCRead-onlyIdempotent
Gets current DNS configuration.
Inputs: device. Returns: result
get_dns_staticARead-onlyIdempotent
Gets details of a specific static DNS entry.
Inputs: entry_id (required), device. Returns: result
get_filter_ruleARead-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_interfaceARead-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_addressBRead-onlyIdempotent
Gets detailed information about a specific IP address by ID or address value.
Inputs: address_id (required), device. Returns: result
get_ip_poolARead-onlyIdempotent
Gets detailed information about a specific IP pool including used address count.
Inputs: name (required), device. Returns: result
get_ipsec_active_peersARead-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_saARead-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 - ESPS 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
Scan mean idle, not broken. An SA nothing has used looks exactly like one that is failing, and RouterOS withholdsaddtimeandexpires-inuntil 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_addressARead-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_ruleBRead-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_ruleARead-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_logsCRead-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_severityBRead-onlyIdempotent
Gets logs filtered by severity level (debug/info/warning/error/critical).
Inputs: severity (required), limit, device, time_filter. Returns: result
get_logs_by_topicARead-onlyIdempotent
Gets logs for a specific topic/facility (system, dhcp, interface, firewall, etc.).
Inputs: topic (required), limit, device, time_filter. Returns: result
get_log_statisticsARead-onlyIdempotent
Gets log entry counts by topic and severity from the MikroTik device.
Inputs: device. Returns: result
get_nat_ruleARead-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_monitorARead-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_settingsARead-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_treeARead-onlyIdempotent
Gets detailed information about a specific queue tree.
Inputs: name (required), device. Returns: result
get_queue_typeCRead-onlyIdempotent
Gets detailed information about a specific queue type.
Inputs: name (required), device. Returns: result
get_raw_ruleARead-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_routeARead-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_cacheCRead-onlyIdempotent
Gets the route cache.
Inputs: device. Returns: result
get_route_statisticsBRead-onlyIdempotent
Gets routing table statistics.
Inputs: device. Returns: result
get_routing_tableCRead-onlyIdempotent
Gets a specific routing table.
Inputs: device, table_name, active_only, protocol_filter. Returns: result
get_security_logsARead-onlyIdempotent
Gets security-related log entries (logins, failures, blocked connections, etc.).
Inputs: limit, device, time_filter. Returns: result
get_simple_queueARead-onlyIdempotent
Gets detailed information about a specific simple queue.
Inputs: name (required), device. Returns: result
get_system_clockBRead-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_eventsBRead-onlyIdempotent
Gets system-related log events (login, reboot, config-change, etc.).
Inputs: limit, device, event_type, time_filter. Returns: result
get_system_healthBRead-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_updateARead-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_resourceBRead-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_routerboardBRead-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_userARead-onlyIdempotent
Gets detailed information about a specific user.
Inputs: name (required), device. Returns: result
get_user_groupARead-onlyIdempotent
Gets detailed information about a specific user group.
Inputs: name (required), device. Returns: result
get_vlan_interfaceARead-onlyIdempotent
Gets detailed information about a specific VLAN interface.
Inputs: name (required), device. Returns: result
get_wireguard_interfaceBRead-onlyIdempotent
Gets detailed information about a specific WireGuard interface.
Inputs: name (required), device. Returns: result
get_wireguard_peerARead-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_interfaceCRead-onlyIdempotent
Gets detailed information about a specific wireless interface.
Inputs: name (required), device. Returns: result
get_wireless_registration_tableBRead-onlyIdempotent
Gets the wireless registration table (connected clients) from the MikroTik device.
Inputs: device, interface. Returns: result
get_wireless_security_profileCRead-onlyIdempotent
Legacy function - not supported in RouterOS v7.x
Inputs: name (required), device. Returns: result
import_configurationCDestructive
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_entriesARead-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_entriesBRead-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_backupsCRead-onlyIdempotent
Lists backup files on the MikroTik device.
Inputs: device, name_filter, include_exports. Returns: result
list_bridge_portsBRead-onlyIdempotent
Lists bridge ports on the MikroTik device, including each port's PVID.
Inputs: device, bridge_filter, interface_filter. Returns: result
list_bridge_vlansBRead-onlyIdempotent
Lists bridge VLAN table entries (tagged/untagged port membership per VLAN).
Inputs: device, dynamic_only, bridge_filter, vlan_ids_filter. Returns: result
list_devicesARead-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_leasesARead-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_serversBRead-onlyIdempotent
Lists DHCP servers on the MikroTik device.
Inputs: device, name_filter, invalid_only, disabled_only, +1 more. Returns: result
list_dhcpv6_bindingsARead-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_staticBRead-onlyIdempotent
Lists static DNS entries.
Inputs: device, name_filter, regexp_only, type_filter, +2 more. Returns: result
list_filter_rulesCRead-onlyIdempotent
Lists firewall filter rules on the MikroTik device.
Inputs: device, chain_filter, dynamic_only, invalid_only, +6 more. Returns: result
list_interfacesARead-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_addressesBRead-onlyIdempotent
Lists IP addresses on the MikroTik device.
Inputs: device, dynamic_only, disabled_only, address_filter, +2 more. Returns: result
list_ip_poolsCRead-onlyIdempotent
Lists IP pools on the MikroTik device.
Inputs: device, name_filter, include_used, ranges_filter. Returns: result
list_ip_pool_usedARead-onlyIdempotent
Lists currently used (allocated) addresses from IP pools.
Inputs: device, pool_name, mac_filter, info_filter, +1 more. Returns: result
list_ipsec_peersARead-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_policiesARead-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_profilesARead-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_proposalsBRead-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_servicesARead-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_addressesARead-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_rulesARead-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_neighborsARead-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_rulesARead-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_rulesBRead-onlyIdempotent
Lists NAT rules on the MikroTik device.
Inputs: device, chain_filter, invalid_only, action_filter, +5 more. Returns: result
list_netwatchARead-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_poeARead-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_treesCRead-onlyIdempotent
Lists queue trees on the MikroTik device.
Inputs: device, name_filter, invalid_only, disabled_only, +1 more. Returns: result
list_queue_typesBRead-onlyIdempotent
Lists queue types on the MikroTik device.
Inputs: device, kind_filter, name_filter. Returns: result
list_raw_rulesARead-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_routesCRead-onlyIdempotent
Lists routes in MikroTik routing table.
Inputs: device, dst_filter, active_only, static_only, +5 more. Returns: result
list_schedulersARead-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_scriptsARead-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_queuesBRead-onlyIdempotent
Lists simple queues on the MikroTik device.
Inputs: device, name_filter, invalid_only, disabled_only, +1 more. Returns: result
list_system_packagesBRead-onlyIdempotent
Lists the installed RouterOS packages and which are disabled.
Inputs: device. Returns: result
list_user_groupsBRead-onlyIdempotent
Lists user groups on MikroTik device.
Inputs: device, name_filter, policy_filter. Returns: result
list_usersCRead-onlyIdempotent
Lists users on MikroTik device.
Inputs: device, active_only, name_filter, group_filter, +1 more. Returns: result
list_user_ssh_keysARead-onlyIdempotent
Lists SSH keys for a specific user.
Inputs: username (required), device. Returns: result
list_vlan_interfacesARead-onlyIdempotent
Lists VLAN interfaces on the MikroTik device.
Inputs: device, name_filter, disabled_only, vlan_id_filter, +1 more. Returns: result
list_wireguard_interfacesCRead-onlyIdempotent
Lists WireGuard interfaces on the MikroTik device.
Inputs: device, name_filter, running_only, disabled_only. Returns: result
list_wireguard_peersBRead-onlyIdempotent
Lists WireGuard peers on the MikroTik device.
Inputs: device, disabled_only, interface_filter. Returns: result
list_wireless_access_listDRead-onlyIdempotent
Legacy function - different in RouterOS v7.x
Inputs: device. Returns: result
list_wireless_interfacesCRead-onlyIdempotent
Lists wireless interfaces on the MikroTik device.
Inputs: device, name_filter, running_only, disabled_only. Returns: result
list_wireless_security_profilesARead-onlyIdempotent
Legacy function - not supported in RouterOS v7.x
Inputs: device. Returns: result
monitor_logsARead-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_ruleAIdempotent
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_ruleBIdempotent
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_ruleBIdempotent
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_ruleBIdempotent
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_ruleBIdempotent
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
pingBRead-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_cpuARead-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_entryBDestructiveIdempotent
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_vlanCDestructiveIdempotent
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_networkCDestructiveIdempotent
Removes a DHCP network configuration from the MikroTik device.
Inputs: network (required), device. Returns: result
remove_dhcp_serverCDestructiveIdempotent
Removes a DHCP server from the MikroTik device.
Inputs: name (required), device. Returns: result
remove_dns_staticCDestructiveIdempotent
Removes a static DNS entry.
Inputs: entry_id (required), device. Returns: result
remove_fileCDestructive
Removes a file from the MikroTik device filesystem.
Inputs: filename (required), device. Returns: result
remove_filter_ruleBDestructiveIdempotent
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_addressCDestructiveIdempotent
Removes an IP address from the MikroTik device by ID or address value.
Inputs: address_id (required), device. Returns: result
remove_ip_poolBDestructiveIdempotent
Removes an IP pool from the MikroTik device (fails if pool is in use).
Inputs: name (required), device. Returns: result
remove_ipv6_addressBDestructiveIdempotent
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_ruleCDestructiveIdempotent
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_ruleBDestructiveIdempotent
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_ruleBDestructiveIdempotent
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_treeCDestructiveIdempotent
Removes a queue tree from the MikroTik device.
Inputs: name (required), device. Returns: result
remove_queue_typeCDestructiveIdempotent
Removes a queue type from the MikroTik device.
Inputs: name (required), device. Returns: result
remove_raw_ruleBDestructiveIdempotent
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_routeBDestructiveIdempotent
Removes a route.
Notes: route_id: "*N" or "N" from list output e.g. "*3"
Inputs: route_id (required), device. Returns: result
remove_simple_queueCDestructiveIdempotent
Removes a simple queue from the MikroTik device.
Inputs: name (required), device. Returns: result
remove_userDDestructiveIdempotent
Removes a user.
Inputs: name (required), device. Returns: result
remove_user_groupCDestructiveIdempotent
Removes a user group.
Inputs: name (required), device. Returns: result
remove_user_ssh_keyCDestructiveIdempotent
Removes an SSH key.
Inputs: key_id (required), device. Returns: result
remove_vlan_interfaceCDestructiveIdempotent
Removes a VLAN interface from the MikroTik device.
Inputs: name (required), device. Returns: result
remove_wireguard_interfaceCDestructiveIdempotent
Removes a WireGuard interface from the MikroTik device.
Inputs: name (required), device. Returns: result
remove_wireguard_peerBDestructiveIdempotent
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_entryDDestructiveIdempotent
Legacy function - different in RouterOS v7.x
Inputs: entry_id (required), device. Returns: result
remove_wireless_interfaceCDestructiveIdempotent
Removes a wireless interface from the MikroTik device.
Inputs: name (required), device. Returns: result
remove_wireless_security_profileCDestructiveIdempotent
Legacy function - not supported in RouterOS v7.x
Inputs: name (required), device. Returns: result
restore_backupCDestructive
Restores a system backup on the MikroTik device; triggers a reboot.
Inputs: filename (required), device, password. Returns: result
rollback_safe_modeADestructiveIdempotent
Discards all pending Safe Mode changes by closing the SSH session, triggering automatic rollback.
Inputs: device. Returns: result
safe_mode_statusARead-onlyIdempotent
Returns whether MikroTik Safe Mode is currently active.
Inputs: device. Returns: result
scan_wireless_networksARead-onlyIdempotent
Scans for nearby wireless networks using the specified interface.
Inputs: interface (required), device, duration. Returns: result
search_logsARead-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_passphraseBIdempotent
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_packetsARead-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_queryCRead-onlyIdempotent
Tests a DNS query.
Notes: type: accepted values are A/ipv4, AAAA/ipv6, any, any6
Inputs: name (required), type, device, server. Returns: result
torchARead-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
tracerouteBRead-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_entryAIdempotent
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_portAIdempotent
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_vlanAIdempotent
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_networkBIdempotent
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_staticDIdempotent
Updates a static DNS entry.
Inputs: entry_id (required), ttl, name, text, +12 more. Returns: result
update_filter_ruleAIdempotent
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_poolBIdempotent
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_ruleCIdempotent
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_ruleBIdempotent
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_ruleBIdempotent
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_treeBIdempotent
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_typeCIdempotent
Updates an existing queue type's discipline-specific settings.
Inputs: name (required), device, cake_mpu, cake_nat, +11 more. Returns: result
update_raw_ruleBIdempotent
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_routeBIdempotent
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_queueAIdempotent
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_userDIdempotent
Updates a user.
Inputs: name (required), group, device, address, +4 more. Returns: result
update_user_groupDIdempotent
Updates a user group.
Inputs: name (required), skin, device, policy, +2 more. Returns: result
update_vlan_interfaceCIdempotent
Updates an existing VLAN interface's settings on the MikroTik device.
Inputs: name (required), arp, mtu, device, +7 more. Returns: result
update_wireguard_interfaceCIdempotent
Updates an existing WireGuard interface's settings on the MikroTik device.
Inputs: name (required), mtu, device, comment, +4 more. Returns: result
update_wireguard_peerAIdempotent
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_interfaceCIdempotent
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
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.
Maintenance
Related MCP Connectors
- DNS-DATA RemoteDeprecatedcom.dns-data
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA bridge between AI assistants and MikroTik RouterOS devices, allowing natural language interaction to manage network configurations including VLANs, firewalls, DNS settings, and more.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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.3MIT
- AlicenseNot gradedqualityCmaintenanceEnables natural language management of MikroTik routers through Cursor IDE by translating requests into RouterOS commands via API or SSH.4MIT
- AlicenseDqualityCmaintenanceEnables managing MikroTik RouterOS devices via natural language, with read-heavy network inspection and guarded write access across multiple routers.261Apache 2.0