create_backup
Create Backup
Creates a system backup on the MikroTik device.
namedevicecommentdont_encryptinclude_password
io.github.wiresage由 GitHub 帳號 wiresage 發布v0.27.0.0更新於 Nov 6, 2026
MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH.
本機 MCP 伺服器,讓助理透過 SSH 管理 MikroTik RouterOS 裝置:防火牆、NAT、路由、VLAN、DHCP、DNS 與備份。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
參照 儲存庫 中的啟動說明。
[MseeP.ai Security Assessment Badge]
[MCP Toplist] [Audited by AddonAudit] [Website] [Build Status] [Tests] [MIT License] [Discord]
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.
https://github.com/user-attachments/assets/24fadcdc-c6a8-48ed-90ac-74baf8f94b59
https://github.com/user-attachments/assets/e0301ff2-8144-4503-83d0-48589d95027d
[!NOTE] Since MikroTik MCP version
0.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
📚 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.
MikroTik MCP is built by the people below. Thank you for every commit, issue, review and idea.
[jeff-nasseri] [goto1134] [vavan11] [shahabbahojb] [lwsinclair] [nieomylnieja] [hassankhurram] [OronF] [pdostal] [inistor] [paoValle] [lucasholman] [lilianmoraru] [Kn-ut99] [vanelin] [siderakis]
Contributions of every kind are welcome: code, bug reports, documentation and reviews all move the project forward. Start with the Contributing Guide.
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.
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.
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.
[Watch the MikroTik MCP presentations on Bisque]
[!NOTE] The Presentations section was added on 3 November 2026, after release
v0.26.2. Releases up tov0.26.2don't have it, and it ships with the next release.
來源:README.md,提交 4d23146
Create Backup
Creates a system backup on the MikroTik device.
namedevicecommentdont_encryptinclude_passwordList Backups
Lists backup files on the MikroTik device.
devicename_filterinclude_exportsCreate Config Export
Creates a configuration export file (rsc/json/xml) on the MikroTik device.
namedevicecommentcompactverboseexport_typefile_formathide_sensitiveExport Config Section
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)
devicecompactsection必填hide_sensitiveDownload File
Downloads a backup or export file from the MikroTik device as base64-encoded content.
devicefilename必填file_typeUpload File
Uploads a base64-encoded file to the MikroTik device (for restore operations).
devicefilename必填content_base64必填Restore Backup
Restores a system backup on the MikroTik device; triggers a reboot.
devicefilename必填passwordImport Configuration
Imports and executes a RouterOS configuration script (.rsc file) on the device.
deviceverbosefilename必填run_after_resetRemove File
Removes a file from the MikroTik device filesystem.
devicefilename必填Backup File Info
Gets detailed information about a backup file on the MikroTik device.
devicefilename必填List Bridge VLANs
Lists bridge VLAN table entries (tagged/untagged port membership per VLAN).
devicedynamic_onlybridge_filtervlan_ids_filterAdd Bridge VLAN
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
bridge必填devicetaggedcommentdisableduntaggedvlan_ids必填Update Bridge VLAN
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.
bridge必填devicetaggedcommentdisableduntaggedvlan_ids必填new_vlan_idsRemove Bridge VLAN
Removes an entry from the bridge VLAN table. Notes: vlan_ids: must match the stored value exactly (it is a list property)
bridge必填devicevlan_ids必填List Bridge Ports
Lists bridge ports on the MikroTik device, including each port's PVID.
devicebridge_filterinterface_filterUpdate Bridge Port
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.
pviddeviceinterface必填frame_typesingress_filteringCreate DHCP Server
Creates a DHCP server bound to the specified interface on the MikroTik device. Notes: lease_time: duration e.g. "1d", "12h", "30m", "1h30m"
name必填devicecommentdisabledinterface必填lease_timeaddress_poolauthoritativedelay_thresholdList DHCP Servers
Lists DHCP servers on the MikroTik device.
devicename_filterinvalid_onlydisabled_onlyinterface_filterList DHCP Leases
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`.
devicemac_filterserver_filterstatus_filteraddress_filterclass_id_filterhostname_filterclient_id_filterlast_seen_withinlease_time_filterList DHCPv6 Bindings
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`.
deviceduid_filteriaid_filterserver_filterstatus_filteraddress_filterlast_seen_withinlease_time_filterGet DHCP Server
Gets detailed information about a specific DHCP server.
name必填deviceCreate DHCP Network
Creates a DHCP network configuration (gateway, DNS, domain, etc.) on the MikroTik device.
devicedomaincommentgateway必填netmasknetwork必填dhcp_optiondns_serversntp_serverswins_serversUpdate DHCP Network
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.
devicedomaincommentgatewaynetmasknetwork必填dhcp_optiondns_serversntp_serverswins_serversRemove DHCP Network
Removes a DHCP network configuration from the MikroTik device.
devicenetwork必填Create DHCP Pool
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"
name必填deviceranges必填commentnext_poolRemove DHCP Server
Removes a DHCP server from the MikroTik device.
name必填deviceSet DNS Servers
Sets DNS server configuration.
deviceservers必填use_dohcache_sizedoh_servercache_max_ttlverify_doh_certmax_udp_packet_sizeallow_remote_requestsmax_concurrent_queriesDNS Settings
Gets current DNS configuration.
deviceAdd DNS Static Entry
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").
ttlname必填textcnamedeviceregexpaddresscommentdisabledsrv_portsrv_targetsrv_weight另有 3 個List DNS Static Entries
Lists static DNS entries.
devicename_filterregexp_onlytype_filterdisabled_onlyaddress_filterGet DNS Static Entry
Gets details of a specific static DNS entry.
deviceentry_id必填Update DNS Static Entry
Updates a static DNS entry.
ttlnametextcnamedeviceregexpaddresscommentdisabledentry_id必填srv_portsrv_target另有 4 個Remove DNS Static Entry
Removes a static DNS entry.
deviceentry_id必填Enable DNS Static Entry
Enables a static DNS entry.
deviceentry_id必填Disable DNS Static Entry
Disables a static DNS entry.
deviceentry_id必填DNS Cache
Gets the current DNS cache.
deviceFlush DNS Cache
Flushes the DNS cache.
deviceDNS Cache Statistics
Gets DNS cache statistics.
deviceAdd DNS Regexp Entry
Adds a DNS regexp entry.
ttldeviceregexp必填address必填commentdisabledTest DNS Query
Tests a DNS query. Notes: type: accepted values are A/ipv4, AAAA/ipv6, any, any6
name必填typedeviceserverExport DNS Config
Exports DNS configuration to a file.
devicefilenameCreate Address List Entry
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.
devicefamily必填address必填commenttimeoutdisabledlist_name必填List Address List Entries
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.
devicefamily必填list_filterstatic_onlydynamic_onlydisabled_onlyaddress_filtercomment_filterGet Address List Entry
Gets one address list entry by list name and address.
devicefamily必填address必填list_name必填Update Address List Entry
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.
devicefamily必填address必填commenttimeoutdisabledlist_name必填new_list_nameRemove Address List Entry
Removes an address list entry by list name and address. Notes: Removing a hostname entry also clears the dynamic entries RouterOS derived from it.
devicefamily必填address必填list_name必填Enable Address List Entry
Enables an address list entry.
devicefamily必填address必填list_name必填Disable Address List Entry
Disables an address list entry.
devicefamily必填address必填list_name必填Create Firewall Filter Rule
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
logchain必填limitaction必填devicecommentdisableddst_portprotocolsrc_porttcp_flagslog_prefix另有 11 個List Firewall Filter Rules
Lists firewall filter rules on the MikroTik device.
devicechain_filterdynamic_onlyinvalid_onlyaction_filterdisabled_onlyprotocol_filterinterface_filterdst_address_filtersrc_address_filterGet Firewall Filter Rule
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")
devicerule_id必填Update Firewall Filter Rule
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="").
logchainlimitactiondevicecommentrule_id必填disableddst_portprotocolsrc_porttcp_flags另有 11 個Remove Firewall Filter Rule
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")
devicerule_id必填Move Filter Rule
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
devicerule_id必填destination必填Enable Filter Rule
Enables a firewall filter rule.
devicerule_id必填Disable Filter Rule
Disables a firewall filter rule.
devicerule_id必填Create Basic Firewall Setup
Creates a basic firewall setup with common security rules on the MikroTik device.
deviceCreate NAT Rule
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"
logchain必填action必填devicecommentdisableddst_portprotocolsrc_portto_portslog_prefixdst_address另有 5 個List NAT Rules
Lists NAT rules on the MikroTik device.
devicechain_filterinvalid_onlyaction_filterdisabled_onlyprotocol_filterinterface_filterdst_address_filtersrc_address_filterGet NAT Rule
Gets detailed information about a specific NAT rule. Notes: rule_id: use the ID from list output e.g. "*1" or "0"
devicerule_id必填Update NAT Rule
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.
logchainactiondevicecommentrule_id必填disableddst_portprotocolsrc_portto_portslog_prefix另有 5 個Remove NAT Rule
Removes a NAT rule from the MikroTik device. Notes: rule_id: use the ID from list output e.g. "*1" or "0"
devicerule_id必填Move NAT Rule
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
devicerule_id必填destination必填Enable NAT Rule
Enables a NAT rule.
devicerule_id必填Disable NAT Rule
Disables a NAT rule.
devicerule_id必填List Interfaces
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 …
devicename_filtertype_filterrunning_onlydisabled_onlyGet Interface
Gets detailed information about a specific interface by name. Notes: name: exact interface name e.g. "ether1", "bridge", "pppoe-out1", "wg0"
name必填deviceEnable Interface
Enables an interface on the MikroTik device. Notes: name: exact interface name e.g. "ether1", "bridge", "pppoe-out1"
name必填deviceDisable Interface
Disables an interface on the MikroTik device. Notes: name: exact interface name e.g. "ether1", "bridge", "pppoe-out1"
name必填deviceList Devices
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.
無需輸入參數。
Add IP Address
Adds an IP address to an interface on the MikroTik device.
deviceaddress必填commentnetworkdisabledbroadcastinterface必填List IP Addresses
Lists IP addresses on the MikroTik device.
devicedynamic_onlydisabled_onlyaddress_filternetwork_filterinterface_filterGet IP Address
Gets detailed information about a specific IP address by ID or address value.
deviceaddress_id必填Remove IP Address
Removes an IP address from the MikroTik device by ID or address value.
deviceaddress_id必填Add IPv6 Address
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.
deviceeui_64no_dadaddress必填commentdisabledadvertisefrom_poolinterface必填List IPv6 Addresses
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.
deviceglobal_onlydynamic_onlydisabled_onlyaddress_filterlink_local_onlyinterface_filterGet IPv6 Address
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").
deviceaddress_id必填Remove IPv6 Address
Removes an IPv6 address from the MikroTik device by ID or address value. Notes: address_id: a RouterOS internal id (e.g. "*1") or the address value (e.g. "2001:db8::1/64").
deviceaddress_id必填Create IPv6 Filter Rule
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".
logchain必填limitaction必填devicecommentheadersdisableddst_portprotocolsrc_porthop_limit另有 14 個List IPv6 Filter Rules
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.
devicechain_filterdynamic_onlyinvalid_onlyaction_filterdisabled_onlyprotocol_filterinterface_filterdst_address_filtersrc_address_filterGet IPv6 Filter Rule
Gets detailed information about a specific IPv6 firewall filter rule. Notes: rule_id: a RouterOS internal id ("*1") or a print position ("0").
devicerule_id必填Update IPv6 Filter Rule
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="").
logchainlimitactiondevicecommentheadersrule_id必填disableddst_portprotocolsrc_port另有 14 個Remove IPv6 Filter Rule
Removes an IPv6 firewall filter rule from the MikroTik device. Notes: rule_id: a RouterOS internal id ("*1") or a print position ("0").
devicerule_id必填Move IPv6 Filter Rule
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
devicerule_id必填destination必填Enable IPv6 Filter Rule
Enables an IPv6 firewall filter rule.
devicerule_id必填Disable IPv6 Filter Rule
Disables an IPv6 firewall filter rule.
devicerule_id必填Add IP Pool
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"
name必填deviceranges必填commentnext_poolList IP Pools
Lists IP pools on the MikroTik device.
devicename_filterinclude_usedranges_filterGet IP Pool
Gets detailed information about a specific IP pool including used address count.
name必填deviceUpdate IP Pool
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.
name必填devicerangescommentnew_namenext_poolRemove IP Pool
Removes an IP pool from the MikroTik device (fails if pool is in use).
name必填deviceList IP Pool Used
Lists currently used (allocated) addresses from IP pools.
devicepool_namemac_filterinfo_filteraddress_filterExpand IP Pool
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"
name必填deviceadditional_ranges必填IPsec Installed SAs
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.
devicedst_address_filtersrc_address_filterIPsec Active Peers
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.
devicestate_filterremote_address_filterList IPsec Peers
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.
devicename_filteraddress_filterList IPsec Policies
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.
devicepeer_filterdst_address_filtersrc_address_filterList IPsec Profiles
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.
devicename_filterList IPsec Proposals
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.
devicename_filterGet Logs
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
limitdevicetopicsprint_astime_filterprefix_filtermessage_filterGet Logs by Severity
Gets logs filtered by severity level (debug/info/warning/error/critical).
limitdeviceseverity必填time_filterGet Logs by Topic
Gets logs for a specific topic/facility (system, dhcp, interface, firewall, etc.).
limittopic必填devicetime_filterSearch Logs
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
limitdevicesearch_term必填time_filtercase_sensitiveSystem Events
Gets system-related log events (login, reboot, config-change, etc.).
limitdeviceevent_typetime_filterSecurity Logs
Gets security-related log entries (logins, failures, blocked connections, etc.).
limitdevicetime_filterClear Logs
Explains why MikroTik's in-memory log cannot be cleared on demand.
deviceLog Statistics
Gets log entry counts by topic and severity from the MikroTik device.
deviceExport Logs
Exports logs to a .txt file on the MikroTik device with optional topic and time filters.
devicetopicsfilenametime_filterMonitor Logs
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
devicetopicsdurationList ARP Entries
Lists detailed IPv4 ARP entries. Notes: Address and MAC filters are substring matches. Interface and status filters are exact matches.
devicemac_filterstatus_filteraddress_filterinterface_filterList IPv6 Neighbors
Lists detailed IPv6 neighbor-discovery entries. Notes: Address and MAC filters are substring matches. Interface and status filters are exact matches.
devicemac_filterstatus_filteraddress_filterinterface_filterList Netwatch Probes
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.
devicehost_filtertype_filterstatus_filtercomment_filterinclude_sourcePoE Monitor
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"
deviceinterfaces必填List PoE
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 …
deviceinterface_filterPoE Settings
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"
name必填deviceCreate Queue Type
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"
kindname必填devicecake_mpucake_natcake_rttpcq_ratecake_washpcq_limitred_burstred_limitsfq_allot另有 16 個List Queue Types
Lists queue types on the MikroTik device.
devicekind_filtername_filterGet Queue Type
Gets detailed information about a specific queue type.
name必填deviceUpdate Queue Type
Updates an existing queue type's discipline-specific settings.
name必填devicecake_mpucake_natcake_rttnew_namepcq_ratecake_washpcq_limitcake_diffservcake_flowmodecake_overhead另有 3 個Remove Queue Type
Removes a queue type from the MikroTik device.
name必填deviceCreate Queue Tree
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)
name必填queuedeviceparent必填commentdisabledlimit_atprioritymax_limitburst_timebucket_sizeburst_limit另有 2 個List Queue Trees
Lists queue trees on the MikroTik device.
devicename_filterinvalid_onlydisabled_onlyparent_filterGet Queue Tree
Gets detailed information about a specific queue tree.
name必填deviceUpdate Queue Tree
Updates an existing queue tree entry (bandwidth limits, parent, priority, etc.). Notes: max_limit / limit_at / burst_limit / burst_threshold: bandwidth e.g. "10M", "512k" burst_time: duration e.g. "8s" priority: 1 (highest) – 8 (lowest)
name必填queuedeviceparentcommentdisabledlimit_atnew_nameprioritymax_limitburst_timebucket_size另有 3 個Remove Queue Tree
Removes a queue tree from the MikroTik device.
name必填deviceEnable Queue Tree
Enables a queue tree.
name必填deviceDisable Queue Tree
Disables a queue tree.
name必填deviceCreate Simple Queue
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)
dstname必填queuedeviceparenttarget必填commentdisabledlimit_atprioritymax_limitburst_time另有 4 個List Simple Queues
Lists simple queues on the MikroTik device.
devicename_filterinvalid_onlydisabled_onlytarget_filterGet Simple Queue
Gets detailed information about a specific simple queue.
name必填deviceUpdate Simple Queue
Updates an existing simple queue's rate limits, target, or scheduling settings. Notes: target: IP/CIDR or interface e.g. "192.168.1.0/24" or "ether1" max_limit / limit_at / burst_limit / burst_threshold: upload/download bandwidth as "UL/DL" e.g. "10M/10M", or single value e.g. "10M" burst_time: duration e.g. "8s" priority: 1 (highest) – 8 (lowest)
dstname必填queuedeviceparenttargetcommentdisabledlimit_atnew_nameprioritymax_limit另有 5 個Remove Simple Queue
Removes a simple queue from the MikroTik device.
name必填deviceEnable Simple Queue
Enables a simple queue.
name必填deviceDisable Simple Queue
Disables a simple queue.
name必填deviceSafe Mode Status
Returns whether MikroTik Safe Mode is currently active.
deviceEnable Safe Mode
Activates MikroTik Safe Mode; changes are held in memory and auto-reverted on disconnect until committed.
deviceCommit Safe Mode
Commits all pending Safe Mode changes to persistent storage and exits Safe Mode.
deviceRollback Safe Mode
Discards all pending Safe Mode changes by closing the SSH session, triggering automatic rollback.
deviceAdd Route
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)
scopedevicecommentgateway必填disableddistancepref_srcdst_address必填target_scopecheck_gatewayrouting_tablevrf_interfaceList Routes
Lists routes in MikroTik routing table.
devicedst_filteractive_onlystatic_onlydynamic_onlydisabled_onlygateway_filterdistance_filterrouting_table_filterGet Route
Gets detailed information about a specific route. Notes: route_id: "*N" or "N" from list output e.g. "*3"
deviceroute_id必填Update Route
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.
scopedevicecommentgatewaydisableddistancepref_srcroute_id必填dst_addresstarget_scopecheck_gatewayrouting_table另有 1 個Remove Route
Removes a route. Notes: route_id: "*N" or "N" from list output e.g. "*3"
deviceroute_id必填Enable Route
Enables a route. Notes: route_id: "*N" or "N" from list output e.g. "*3"
deviceroute_id必填Disable Route
Disables a route. Notes: route_id: "*N" or "N" from list output e.g. "*3"
deviceroute_id必填Routing Table
Gets a specific routing table.
devicetable_nameactive_onlyprotocol_filterCheck Route Path
Checks the route MikroTik would use to reach a destination.
devicedestination必填Get Route Cache
Gets the route cache.
deviceFlush Route Cache
Flushes the route cache.
deviceAdd Default Route
Adds a default route.
devicecommentgateway必填distancecheck_gatewayAdd Blackhole Route
Adds a blackhole route. Notes: dst_address: CIDR e.g. "10.0.0.0/8" distance: 1-255
devicecommentdistancedst_address必填Route Statistics
Gets routing table statistics.
deviceList Schedulers
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.
devicename_filterinclude_sourceList Scripts
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.
devicename_filterinclude_sourceList IP Services
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.
devicename_filterenabled_onlySystem Resource
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.
deviceSystem Health
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".
deviceSystem Clock
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.
deviceRouterBOARD Info
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.
deviceList Packages
Lists the installed RouterOS packages and which are disabled.
deviceCheck for Updates
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.
deviceAdd User
Adds a user to MikroTik device.
name必填groupdeviceaddresscommentdisabledpassword必填List Users
Lists users on MikroTik device.
deviceactive_onlyname_filtergroup_filterdisabled_onlyGet User
Gets detailed information about a specific user.
name必填deviceUpdate User
Updates a user.
name必填groupdeviceaddresscommentdisablednew_namepasswordRemove User
Removes a user.
name必填deviceDisable User
Disables a user.
name必填deviceEnable User
Enables a user.
name必填deviceAdd User Group
Adds a user group.
name必填skindevicepolicy必填commentList User Groups
Lists user groups on MikroTik device.
devicename_filterpolicy_filterGet User Group
Gets detailed information about a specific user group.
name必填deviceUpdate User Group
Updates a user group.
name必填skindevicepolicycommentnew_nameRemove User Group
Removes a user group.
name必填deviceActive Users
Gets currently active/logged-in users.
deviceDisconnect User
Disconnects an active user session.
deviceuser_id必填Export User Config
Exports user configuration to a file.
devicefilenameSet User SSH Keys
Sets SSH keys for a specific user.
devicekey_file必填username必填List User SSH Keys
Lists SSH keys for a specific user.
deviceusername必填Remove User SSH Key
Removes an SSH key.
devicekey_id必填Create VLAN
Creates a VLAN interface on the MikroTik device with the given VLAN ID and parent interface.
arpmtuname必填devicecommentvlan_id必填disabledinterface必填arp_timeoutuse_service_tagList VLANs
Lists VLAN interfaces on the MikroTik device.
devicename_filterdisabled_onlyvlan_id_filterinterface_filterGet VLAN
Gets detailed information about a specific VLAN interface.
name必填deviceUpdate VLAN
Updates an existing VLAN interface's settings on the MikroTik device.
arpmtuname必填devicecommentvlan_iddisablednew_nameinterfacearp_timeoutuse_service_tagRemove VLAN
Removes a VLAN interface from the MikroTik device.
name必填deviceCreate Wireless Interface
Creates a wireless interface on the MikroTik device (auto-detects RouterOS v6/v7 syntax).
bandmodename必填ssiddevicecommentdisabledfrequencyradio_namechannel_widthsecurity_profileList Wireless Interfaces
Lists wireless interfaces on the MikroTik device.
devicename_filterrunning_onlydisabled_onlyGet Wireless Interface
Gets detailed information about a specific wireless interface.
name必填deviceRemove Wireless Interface
Removes a wireless interface from the MikroTik device.
name必填deviceEnable Wireless Interface
Enables a wireless interface.
name必填deviceDisable Wireless Interface
Disables a wireless interface.
name必填deviceScan Wireless Networks
Scans for nearby wireless networks using the specified interface.
devicedurationinterface必填Wireless Registration Table
Gets the wireless registration table (connected clients) from the MikroTik device.
deviceinterfaceCheck Wireless Support
Checks if the device supports wireless and reports the RouterOS version and wireless interface type.
deviceCreate Wireless Security Profile
Legacy function - not supported in RouterOS v7.x
name必填deviceList Wireless Security Profiles
Legacy function - not supported in RouterOS v7.x
deviceGet Wireless Security Profile
Legacy function - not supported in RouterOS v7.x
name必填deviceRemove Wireless Security Profile
Legacy function - not supported in RouterOS v7.x
name必填deviceSet Wireless Security Profile
Legacy function - not supported in RouterOS v7.x
deviceinterface_name必填security_profile必填Create Wireless Access List
Legacy function - different in RouterOS v7.x
deviceList Wireless Access List
Legacy function - different in RouterOS v7.x
device已滿足適用檢查項的 90%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。