io.github.jeff-nasseri/mikrotik-mcp MCP Server
io.github.jeff-nasseri/mikrotik-mcp
Manage MikroTik routers via AI: firewall, NAT, routing, DHCP, DNS, WireGuard, and more through natural language.
What this kind of tool is for
- Automate a build, test, or deployment step you repeat by hand.
- Review or refactor code in an existing repository without leaving your agent.
- Bridge an internal service or CLI into the agent toolset.
How to compare servers like this
- Scope of control:
- Repos and CI are hard to undo; prefer tools that ask before anything irreversible.
- Environment fit:
- Match the runtime it expects (Node, Python, a container) to what you actually run.
- Maintenance signal:
- Check the last-commit date — dev tooling that lags upstream breaks first.
- Config surface:
- Prefer tools whose environment-variable or config keys are documented plainly.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the io.github.jeff-nasseri/mikrotik-mcp MCP server?
The MikroTik MCP server is a bridge between AI assistants and MikroTik RouterOS devices, enabling natural language control of router configuration and management. It allows AI to interact with MikroTik routers to execute commands like managing VLANs, configuring firewall rules, handling DNS settings, and more.
MikroTik MCP connects Claude and other AI assistants to MikroTik routers over SSH, letting you manage network infrastructure through conversation. Configure firewall rules, NAT, routing, DHCP, DNS, WireGuard, and other router functions without manual CLI access. Supports managing multiple devices in a fleet.
How to install io.github.jeff-nasseri/mikrotik-mcp
Copy-paste configuration for popular MCP clients.
MIKROTIK_HOSTIP address or hostname of the MikroTik router (single-device mode; default: 127.0.0.1). Not needed when an inventory is configured.
MIKROTIK_USERNAMESSH username for the MikroTik router (single-device mode; default: admin)
MIKROTIK_PASSWORDsecretSSH password for the MikroTik router (single-device mode)
MIKROTIK_PORTSSH port of the MikroTik router (single-device mode; default: 22)
MIKROTIK_KEY_FILENAMEPath to SSH private key file for key-based authentication (single-device mode)
MIKROTIK_READ_ONLYWhen 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_HIDINGWhen 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_FILEPath to a YAML file listing multiple MikroTik devices (title, host, port, username, password, key_filename, tags, region). See docs/reference/inventory.
MIKROTIK_INVENTORYsecretInline multi-device inventory as a YAML (or JSON) list; takes precedence over MIKROTIK_INVENTORY_FILE and the single-device variables. Holds credentials.
{
"mcpServers": {
"mikrotik-mcp": {
"command": "uvx",
"args": [
"mcp-server-mikrotik"
],
"env": {
"MIKROTIK_HOST": "<YOUR_MIKROTIK_HOST>",
"MIKROTIK_USERNAME": "<YOUR_MIKROTIK_USERNAME>",
"MIKROTIK_PASSWORD": "<YOUR_MIKROTIK_PASSWORD>",
"MIKROTIK_PORT": "<YOUR_MIKROTIK_PORT>",
"MIKROTIK_KEY_FILENAME": "<YOUR_MIKROTIK_KEY_FILENAME>",
"MIKROTIK_READ_ONLY": "<YOUR_MIKROTIK_READ_ONLY>",
"MIKROTIK_SENSITIVE_HIDING": "<YOUR_MIKROTIK_SENSITIVE_HIDING>",
"MIKROTIK_INVENTORY_FILE": "<YOUR_MIKROTIK_INVENTORY_FILE>",
"MIKROTIK_INVENTORY": "<YOUR_MIKROTIK_INVENTORY>"
}
}
}
}Tools & capabilities
Tools this server exposes to the agent.
Firewall Management— Configure and manage firewall rules on MikroTik routersNAT Configuration— Set up and manage Network Address TranslationRouting— Configure routing policies and routesDHCP— Manage DHCP server settings and leasesDNS— Configure DNS settings and resolutionWireGuard— Set up and manage WireGuard VPNVLAN Management— Create and manage virtual LANsMulti-Device Inventory— Manage multiple MikroTik devices in a fleet
Use cases
- Configure firewall rules and security policies on MikroTik routers using natural language requests
- Set up and manage VPN connections with WireGuard through conversational commands
- Manage DHCP and DNS settings across multiple routers in your network
- Create and configure VLANs and routing policies without direct CLI access
- Monitor and control NAT rules and network address translation settings
io.github.jeff-nasseri/mikrotik-mcp MCP server FAQ
It's an MCP server that bridges AI assistants like Claude with MikroTik RouterOS devices, allowing you to manage routers through natural language commands via SSH connection.
Yes, MikroTik MCP is licensed under the MIT License and is free to use, modify, and distribute.
Install via PyPI (`pip install mcp-server-mikrotik`) and configure it in Claude Desktop using the integration guide at docs/integrations/claude-desktop.md.
You need SSH credentials (username and password or key-based auth) for your MikroTik router(s) to establish a connection.
Yes, since version 0.14.0, MikroTik MCP supports managing multiple MikroTik devices within a fleet structure through an inventory system.
You can manage firewall rules, NAT, routing, DHCP, DNS, WireGuard VPN, VLANs, and other RouterOS features through the MCP interface.
README (reference)
Source of truth, from the repository.
MikroTik MCP
<!-- mcp-name: io.github.jeff-nasseri/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.
Quick Links
- Installation Guide - Get started with MikroTik MCP
- Testing Guide - Run integration tests
- Claude Desktop Integration - Configure for Claude Desktop
- MCP Inspector - Interactive testing tool
- Contributing Guide - Help improve MikroTik MCP
- Articles - Learning resources and tutorials
- Diagrams - Architecture and design diagrams (draw.io)
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.
Related MCP servers

io.github.jeff-nasseri/revolut-mcp
AI-powered Revolut Business API access: accounts, transactions, payments, FX, and counterparty management.
Remote MCP for 1,500+ APIs. Vault-managed credentials; OAuth or API key. Search, load, and execute.

io.github.jeongho54/loadbench
MCP server for structural load & stability math: tipping, support reactions, beam checks.
MCP server for managing Coalesce Transform workspaces, nodes, pipelines, and runs.
View repository →Read published house pizza facts and calculate dough and ingredient balance.

health4ai
Query your Apple Health data from your own Supabase/Postgres via local MCP.

