io.github.wiresage/mikrotik-mcp

Official registry Search and web

MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package mcp-server-mikrotik
Claude Code
claude mcp add mikrotik-mcp -e 'MIKROTIK_HOST=<MIKROTIK_HOST>' -e 'MIKROTIK_USERNAME=<MIKROTIK_USERNAME>' -e 'MIKROTIK_PASSWORD=<your mikrotik_password>' -e 'MIKROTIK_PORT=<MIKROTIK_PORT>' -e 'MIKROTIK_KEY_FILENAME=<MIKROTIK_KEY_FILENAME>' -e 'MIKROTIK_READ_ONLY=<MIKROTIK_READ_ONLY>' -e 'MIKROTIK_SENSITIVE_HIDING=<MIKROTIK_SENSITIVE_HIDING>' -e 'MIKROTIK_INVENTORY_FILE=<MIKROTIK_INVENTORY_FILE>' -e 'MIKROTIK_INVENTORY=<your mikrotik_inventory>' -- uvx mcp-server-mikrotik==0.26.2.0
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "mikrotik-mcp": {
            "command": "uvx",
            "args": [
                "mcp-server-mikrotik==0.26.2.0"
            ],
            "env": {
                "MIKROTIK_HOST": "<MIKROTIK_HOST>",
                "MIKROTIK_USERNAME": "<MIKROTIK_USERNAME>",
                "MIKROTIK_PASSWORD": "<your mikrotik_password>",
                "MIKROTIK_PORT": "<MIKROTIK_PORT>",
                "MIKROTIK_KEY_FILENAME": "<MIKROTIK_KEY_FILENAME>",
                "MIKROTIK_READ_ONLY": "<MIKROTIK_READ_ONLY>",
                "MIKROTIK_SENSITIVE_HIDING": "<MIKROTIK_SENSITIVE_HIDING>",
                "MIKROTIK_INVENTORY_FILE": "<MIKROTIK_INVENTORY_FILE>",
                "MIKROTIK_INVENTORY": "<your mikrotik_inventory>"
            }
        }
    }
}

Environment variables

  • MIKROTIK_HOST IP address or hostname of the MikroTik router (single-device mode; default: 127.0.0.1). Not needed when an inventory is configured.
  • MIKROTIK_USERNAME SSH username for the MikroTik router (single-device mode; default: admin)
  • MIKROTIK_PASSWORD secret SSH password for the MikroTik router (single-device mode)
  • MIKROTIK_PORT SSH port of the MikroTik router (single-device mode; default: 22)
  • MIKROTIK_KEY_FILENAME Path to SSH private key file for key-based authentication (single-device mode)
  • MIKROTIK_READ_ONLY When true, expose only tools that do not modify RouterOS or its file store. Use a read-only RouterOS account as defence in depth.
  • MIKROTIK_SENSITIVE_HIDING When true, redact recognized credentials and private key material from tool results, MCP notifications, and logs, and omit tools that return opaque sensitive payloads.
  • MIKROTIK_INVENTORY_FILE Path to a YAML file listing multiple MikroTik devices (title, host, port, username, password, key_filename, tags, region). See docs/reference/inventory.
  • MIKROTIK_INVENTORY secret Inline multi-device inventory as a YAML (or JSON) list; takes precedence over MIKROTIK_INVENTORY_FILE and the single-device variables. Holds credentials.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. MikroTik MCP
  2. Overview
  3. Demo Videos
  4. Documentation
  5. Contributors ❤️
  6. Community
  7. License

MikroTik MCP

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.

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 - 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.

Contributors ❤️

MikroTik MCP is built by the people below. Thank you for every commit, issue, review and idea.

Contributions of every kind are welcome: code, bug reports, documentation and reviews all move the project forward. Start with the Contributing Guide.

Community

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.

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.

Frequently asked questions

What is io.github.wiresage/mikrotik-mcp?

MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH.

How do I install io.github.wiresage/mikrotik-mcp?

It runs on your machine. In Claude Code: claude mcp add mikrotik-mcp -e 'MIKROTIK_HOST=<MIKROTIK_HOST>' -e 'MIKROTIK_USERNAME=<MIKROTIK_USERNAME>' -e 'MIKROTIK_PASSWORD=<your mikrotik_password>' -e 'MIKROTIK_PORT=<MIKROTIK_PORT>' -e 'MIKROTIK_KEY_FILENAME=<MIKROTIK_KEY_FILENAME>' -e 'MIKROTIK_READ_ONLY=<MIKROTIK_READ_ONLY>' -e 'MIKROTIK_SENSITIVE_HIDING=<MIKROTIK_SENSITIVE_HIDING>' -e 'MIKROTIK_INVENTORY_FILE=<MIKROTIK_INVENTORY_FILE>' -e 'MIKROTIK_INVENTORY=<your mikrotik_inventory>' -- uvx mcp-server-mikrotik==0.26.2.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.wiresage/mikrotik-mcp need an API key?

Yes. It expects MIKROTIK_PASSWORD, MIKROTIK_INVENTORY, which you set in its configuration.

Is io.github.wiresage/mikrotik-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.wiresage/mikrotik-mcp?

It is published by wiresage. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.