mikrotik

Query and modify MikroTik RouterOS configuration over API, REST, Telnet, SSH, and WinBox transports.

198|97|Updated Aug 16, 2015
One-click install
npx skills add https://github.com/danikf/tik4net --skill mikrotik-danikf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mikrotik
Source: https://github.com/danikf/tik4net/tree/main/.claude/skills/mikrotik
Command: npx skills add https://github.com/danikf/tik4net --skill mikrotik-danikf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing MikroTik routers requires working across many different access protocols, and switching between them normally means rewriting client code or reconfiguring the router. This Skill lets you inspect, modify, and debug RouterOS devices through a single MCP tool that speaks every transport — API, REST, Telnet, SSH, MAC-Telnet, and WinBox — with one identical command format. ## Core Features & Use Cases - Unified multi-transport access: Run the same command (e.g. /ip/firewall/filter/print) over any of 11 transports, from plain API to encrypted WinBox CLI, without changing parameters. - Read and write operations: List interfaces, routes, DHCP leases, and firewall rules, or add/set/remove entries and execute action verbs like /system/reboot via executeMode: nonquery. - Protocol debugging: Compare any transport against the API baseline, capture word-level or byte-level wire traces, and pull the router's own /log to diagnose hangs and mis-mapped fields. - Network discovery: Find MikroTik devices on the local segment via MNDP broadcast when IP or MAC addresses are unknown. - Use Case: A network engineer needs to audit NAT rules on a router whose IP changed after a rebuild — use mikrotik_discover to locate it by MAC, then connect over MAC-Telnet to read and fix the configuration. ## Quick Start Ask the assistant to list all interfaces on the default test router using the mikrotik skill, or provide a host, username, and password to query your own device.

Frequently Asked Questions about mikrotik

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a command on a MikroTik router from an AI assistant?

Call the mikrotik_call MCP tool with the host, credentials, and a RouterOS command path such as /ip/address/print. The default transport is the binary API on port 8728, and results return as JSON records for print commands or an OK confirmation for writes.

How can I find a MikroTik router on my network without knowing its IP?

Use the mikrotik_discover tool, which listens for MNDP broadcasts on UDP 5678 and returns each router's identity, IP, MAC, version, and board name. The returned MAC address can then be used with MAC-layer transports like MacTelnet or WinboxCliMac.

Which connection types does tik4net support for RouterOS?

tik4net supports API, API-SSL, REST, REST-SSL, Telnet, SSH, MAC-Telnet, WinBox CLI, WinBox CLI over MAC, WinBox Native (M2), and WinBox Native over MAC. Only API transports support async listen/streaming; all others are request/response.

Why does /system/script/run fail with NotSupportedException over Telnet or WinBox?

Action verbs like run, reboot, or reset-counters return no result set, and CLI transports dispatch unknown verbs as reads by default. Pass executeMode: nonquery so the command is invoked via ExecuteNonQuery instead of the print/read path.

Can I debug why a WinBox or Telnet command returns wrong data?

Yes. Set traceLevel to words to see the raw exchange, or bytes for a full wire trace including terminal negotiation and framing decisions. Adding includeRouterLog: true appends the router's own /log entries captured during the command.

Does MNDP discovery work across subnets or with a host firewall?

No. MNDP is a layer-2 broadcast that does not cross routers, and a host firewall silently dropping inbound broadcasts produces an empty result. An empty discovery result does not prove the router is down; confirm with a direct mikrotik_call.