Skip to main content
Glama
halid9

io.github.jeff-nasseri/mikrotik-mcp

by halid9

MikroTik MCP

Website Build Status Tests MIT License

Overview

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.

With ~300 tools, it covers practically the whole RouterOS surface: system core (identity, clock, NTP, packages/upgrade, scripts, scheduler, logging), L2 switching (bridge + VLAN filtering, bonding, VRRP, VXLAN), tunnels and VPN (EoIP/GRE/IPIP/6to4, PPP/PPPoE/L2TP/SSTP/OVPN, IPsec, WireGuard), the full firewall (filter/NAT/mangle/raw/address-list/connection), IPv4 and IPv6 (addresses, routes, DHCP client/server/leases, IPv6 firewall), routing protocols (OSPF, BGP, RIP, BFD), certificates (incl. ACME), ROS7 WiFi + legacy CAPsMAN, LTE, containers, and diagnostics (ping, traceroute, bandwidth-test, torch, sniffer, netwatch).

Tool design

  • Legacy scopes (the original ~170 tools) use one tool per action: create_vlan_interface, list_vlan_interfaces, remove_vlan_interface, …

  • Consolidated scopes (newer tools) use one tool per RouterOS menu with an action parameter, e.g. bridge_port(action="add", …) / action="list" / action="remove". This keeps the tool count manageable while covering every verb.

  • Most consolidated tools take an attributes dict — an escape hatch to pass any RouterOS property (kebab-case) not exposed as a typed parameter.

  • execute_command runs a raw RouterOS CLI command — the fallback for anything not covered by a dedicated tool. Safe mode, when enabled, still applies.

Tools carry MCP risk annotations (read-only / write / destructive / dangerous) so clients can gate confirmations appropriately.

Related MCP server: RouterOS MCP Server

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

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.

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.

Maintenance

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

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