Skip to content
MCP server

MikroMCP

Typed, auditable tools for MikroTik RouterOS routers and SwOS switches

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.16.1
Listing updated
today

Similar MCP servers

About MikroMCP

MikroMCP is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

Rather than letting a model improvise shell commands on production network gear, MikroMCP puts 133 schema-validated tools between the agent and the router. It targets MikroTik RouterOS through the REST API, with SSH used only for ping and a guarded run_command, and has experimental support for SwOS and SwOS Lite switches.

Change safety is the core idea: dry-run previews, idempotent writes, snapshots, a write journal, plan_changes and apply_plan for staged work, and rollback_change to undo. Read tools retry, each router has its own circuit breaker, and every call carries a correlation ID in structured and audit logs. Coverage runs from interfaces, VLANs, firewall and NAT rules to BGP peers, OSPF neighbours, WireGuard peers and diagnostics such as traceroute and torch.

It runs over stdio, Streamable HTTP or legacy SSE. HTTP mode adds bearer-token auth with bcrypt hashes, RBAC and router or tool restrictions. A router registry YAML defaults to ~/.mikromcp/routers.yaml.

Install

Run in a terminal

claude mcp add mikromcp -- npx -y mikromcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mikromcp": {
      "command": "npx",
      "args": [
        "-y",
        "mikromcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mikromcp": {
      "command": "npx",
      "args": [
        "-y",
        "mikromcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mikromcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mikromcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mikromcp": {
      "command": "npx",
      "args": [
        "-y",
        "mikromcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mikromcp": {
      "command": "npx",
      "args": [
        "-y",
        "mikromcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MIKROMCP_CONFIG_PATHPath to the MikroMCP router registry YAML file. Defaults to ~/.mikromcp/routers.yaml.
  • MIKROMCP_STDIO_IDENTITYOptional identity name for stdio transport RBAC. Omit to use the built-in superadmin identity.
  • MIKROMCP_LOG_LEVELOptional log level: trace, debug, info, warn, or error. Defaults to info.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

plan_changes
Builds a change plan for review before applying.
apply_plan
Applies a previously created change plan.
rollback_change
Rolls back a recorded change.
run_command
Guarded SSH command execution on a router.

What it does

133 typed tools
Covers system, interfaces, firewall, routing, DHCP, DNS and more.
Dry-run and rollback
plan_changes, apply_plan and rollback_change wrap writes in a reviewable workflow.
RBAC and audit logs
Per-identity tool and router restrictions, with audit logging.
SwOS switch support
Experimental port, PoE and SFP data plus whole-config YAML export and apply.
Diagnostics
ping, traceroute, torch and log filtering run from the router.
Several transports
stdio, Streamable HTTP and legacy SSE.

Good for

  • Summarise a router's health, routes and recent errors
  • Audit firewall rules for broad accepts and missing comments
  • Preview a static route change before applying it
  • Check WireGuard peer handshakes across branch routers
  • Back up and apply a SwOS switch configuration

Pricing

Open source

Free open-source npm package.

MikroMCP FAQ

Is it open source?

Yes, the README calls it an open-source MCP server.

Does it work with SwOS switches?

Yes, experimentally, over the reverse-engineered .b HTTP API.

How do I configure routers?

List them in a YAML registry, by default ~/.mikromcp/routers.yaml, set with MIKROMCP_CONFIG_PATH.

Which clients can use it?

Claude, Cursor, Codex and other MCP clients over stdio or HTTP.

Is MikroMCP free?

Yes. MikroMCP is open source, so you can use and self-host it for free.

How do I add MikroMCP to Claude Code?

Run this command in your terminal: claude mcp add mikromcp -- npx -y mikromcp

What are the best alternatives to MikroMCP?

The closest alternatives to MikroMCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers