Skip to main content
Glama
io.github.jeff-nasseri/mikrotik-mcp

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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
    • A
      license
      C
      quality
      A
      maintenance
      Provides a bridge between AI assistants and MikroTik RouterOS devices, enabling natural language management of VLANs, firewall rules, DNS settings, and more.
      239
      1,052 PyPI
      337
      MIT