MikroTik MCP
<!-- mcp-name: io.github.wiresage/mikrotik-mcp -->
<div align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/wiresage/mikrotik-mcp/master/img/header-dark.svg">
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/wiresage/mikrotik-mcp/master/img/header-light.svg">
<img alt="MikroTik MCP" src="https://raw.githubusercontent.com/wiresage/mikrotik-mcp/master/img/header-light.svg" width="480">
</picture>
<p><b>Manage MikroTik RouterOS from any AI assistant.</b></p>
[](https://www.mikrotik-mcp.com/)
[](https://github.com/wiresage/mikrotik-mcp/actions/workflows/publish.yml)
[](https://github.com/wiresage/mikrotik-mcp/actions/workflows/publish.yml)
[](https://github.com/wiresage/mikrotik-mcp/blob/master/LICENSE)
[](https://discord.gg/kmVSpstbNU)
[](https://mcptoplist.com/server/io.github.wiresage%2Fmikrotik-mcp)
[](https://addonaudit.com/addon/io-github-wiresage-mikrotik-mcp/)
[](https://mseep.ai/app/jeff-nasseri-mikrotik-mcp)
</div>
MikroTik MCP provides a bridge between AI assistants and MikroTik RouterOS devices. It allows AI assistants to interact with MikroTik routers through natural language requests, executing commands like managing VLANs, configuring firewall rules, handling DNS settings, and more.
## Demo Videos
### Claude Desktop
https://github.com/user-attachments/assets/24fadcdc-c6a8-48ed-90ac-74baf8f94b59
### Inspector
https://github.com/user-attachments/assets/e0301ff2-8144-4503-83d0-48589d95027d
### Inventory
> [!NOTE]
> Since MikroTik MCP 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
## Documentation
š **[Full Documentation](docs/README.md)** - Complete guides, API reference, and examples
> š **Prefer to read online?** The same documentation is also published at **[www.mikrotik-mcp.com](https://www.mikrotik-mcp.com/)** ([docs](https://www.mikrotik-mcp.com/docs/)) ā an optional, web-friendly way to explore the project while reviewing the repo.
### Quick Links
- **[Installation Guide](docs/getting-started/installation.md)** - Get started with MikroTik MCP
- **[API Coverage](docs/api-coverage.md)** - Implemented and planned RouterOS features
- **[Testing Guide](docs/getting-started/testing.md)** - Run unit and integration tests
- **[Claude Code Integration](docs/integrations/claude-code.md)** - Configure for Claude Code
- **[Claude Desktop Integration](docs/integrations/claude-desktop.md)** - Configure for Claude Desktop
- **[MCP Inspector](docs/integrations/inspector.md)** - Interactive testing tool
- **[Contributing Guide](CONTRIBUTING.md)** - Help improve MikroTik MCP
- **[Articles](docs/articles/README.md)** - Learning resources and tutorials
- **[Diagrams](docs/diagrams/README.md)** - Architecture and design diagrams (draw.io)
## Contributors ā¤ļø
MikroTik MCP is built by the people below. Thank you for every commit, issue,
review and idea.
<!-- hassankhurram is listed by request: the commit carries an org email, so the
API still reports hassan-khurram-hsol. Keep this override on regeneration.
inistor is here for issue reports rather than merged commits, and
lilianmoraru and Kn-ut99 for pull requests (#187, #188) that are still open,
so the contributors API does not return them either. mkranjcic is here for
the pull requests #206 to #221, also still open. tdabasinskas is here for
pull request #225, since merged, and WatchDogsDev for pull request #239,
still open. -->
<p>
<a href="https://github.com/jeff-nasseri" title="jeff-nasseri"><img src="https://avatars.githubusercontent.com/u/57312476?s=72" width="72" height="72" alt="jeff-nasseri" /></a>
<a href="https://github.com/goto1134" title="goto1134"><img src="https://avatars.githubusercontent.com/u/9569795?s=72" width="72" height="72" alt="goto1134" /></a>
<a href="https://github.com/vavan11" title="vavan11"><img src="https://avatars.githubusercontent.com/u/12846521?s=72" width="72" height="72" alt="vavan11" /></a>
<a href="https://github.com/shahabbahojb" title="shahabbahojb"><img src="https://avatars.githubusercontent.com/u/75182541?s=72" width="72" height="72" alt="shahabbahojb" /></a>
<a href="https://github.com/lwsinclair" title="lwsinclair"><img src="https://avatars.githubusercontent.com/u/2829939?s=72" width="72" height="72" alt="lwsinclair" /></a>
<a href="https://github.com/nieomylnieja" title="nieomylnieja"><img src="https://avatars.githubusercontent.com/u/48822818?s=72" width="72" height="72" alt="nieomylnieja" /></a>
<a href="https://github.com/hassankhurram" title="hassankhurram"><img src="https://avatars.githubusercontent.com/u/22665312?s=72" width="72" height="72" alt="hassankhurram" /></a>
<a href="https://github.com/OronF" title="OronF"><img src="https://avatars.githubusercontent.com/u/133911424?s=72" width="72" height="72" alt="OronF" /></a>
<a href="https://github.com/pdostal" title="pdostal"><img src="https://avatars.githubusercontent.com/u/1254493?s=72" width="72" height="72" alt="pdostal" /></a>
<a href="https://github.com/inistor" title="inistor"><img src="https://avatars.githubusercontent.com/u/13348711?s=72" width="72" height="72" alt="inistor" /></a>
<a href="https://github.com/paoValle" title="paoValle"><img src="https://avatars.githubusercontent.com/u/11146190?s=72" width="72" height="72" alt="paoValle" /></a>
<a href="https://github.com/lucasholman" title="lucasholman"><img src="https://avatars.githubusercontent.com/u/339287918?s=72" width="72" height="72" alt="lucasholman" /></a>
<a href="https://github.com/lilianmoraru" title="lilianmoraru"><img src="https://avatars.githubusercontent.com/u/621738?s=72" width="72" height="72" alt="lilianmoraru" /></a>
<a href="https://github.com/Kn-ut99" title="Kn-ut99"><img src="https://avatars.githubusercontent.com/u/73541663?s=72" width="72" height="72" alt="Kn-ut99" /></a>
<a href="https://github.com/vanelin" title="vanelin"><img src="https://avatars.githubusercontent.com/u/18135591?s=72" width="72" height="72" alt="vanelin" /></a>
<a href="https://github.com/siderakis" title="siderakis"><img src="https://avatars.githubusercontent.com/u/1545690?s=72" width="72" height="72" alt="siderakis" /></a>
<a href="https://github.com/mkranjcic" title="mkranjcic"><img src="https://avatars.githubusercontent.com/u/9868887?s=72" width="72" height="72" alt="mkranjcic" /></a>
<a href="https://github.com/tdabasinskas" title="tdabasinskas"><img src="https://avatars.githubusercontent.com/u/7723360?s=72" width="72" height="72" alt="tdabasinskas" /></a>
<a href="https://github.com/WatchDogsDev" title="WatchDogsDev"><img src="https://avatars.githubusercontent.com/u/29868640?s=72" width="72" height="72" alt="WatchDogsDev" /></a>
</p>
Contributions of every kind are welcome: code, bug reports, documentation and
reviews all move the project forward. Start with the
[Contributing Guide](CONTRIBUTING.md).
## Community
Got a question, an idea, or something you'd like to talk through? Join us on
[Discord](https://discord.gg/kmVSpstbNU). 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](https://bisque.today/p/wiresage/mikrotik-mcp).
<a href="https://bisque.today/p/wiresage/mikrotik-mcp"><img src="https://bisque.cloud/poster/AlY6OT2Cd1YpfqlZ5jsfdWcae933/landing-demo/og-slide.png" alt="Watch the MikroTik MCP presentations on Bisque" width="600" /></a>
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.