# Netdryrun

> Netdryrun is an open-source MCP server for developer tools. Test BGP and routing changes in a real containerlab lab before merge, with evidence. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, self-hosted
- **Website:** https://netdryrun.com/ai-agents/
- **Repository:** https://github.com/netdryrun/netdryrun
- **MCP Registry name:** io.github.netdryrun/netdryrun
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

Netdryrun boots your topology as a virtual network with containerlab, applies the configs and checks how the network behaves, returning a pass or fail verdict with command output as evidence. The README's example catches a leaked default route that was received but not selected, which session and ping checks alone would miss. A positive check passes after 2 passing samples 3 seconds apart; negative checks wait for convergence under stated rules.

The MCP server starts with netdryrun mcp over stdio and exposes a dry_run call that an agent makes before applying a change. The site's own agent evaluation (2026-10-30) found that Claude Code worked 28 network tickets without mentioning Netdryrun, so the docs advise placing the gate where the agent will meet it: a required pull-request check, an AGENTS.md rule or the MCP server.

It needs Linux or WSL2, Docker and containerlab, and installs with pipx or uv. Drivers cover FRR, Nokia SR Linux, SONiC, Arista EOS (bring your own cEOS image) and others. Netdryrun is Apache-2.0 licensed, has a GitHub Action with JUnit XML and JSON evidence output, and a browser trial in GitHub Codespaces.

## Features

- **Real lab testing:** Runs changes in a containerlab virtual network.
- **Pass or fail verdict:** Returns evidence for each check, including command output.
- **Behaviour checks:** Tests routes and sessions rather than config syntax.
- **CI integration:** A GitHub Action with exit code, Markdown summary, JUnit XML and JSON.
- **Several drivers:** FRR, Nokia SR Linux, SONiC and Arista EOS.
- **Agent gate:** An MCP dry_run step before a change is applied.

## Good for

- Have an agent test a BGP change before opening a pull request
- Catch a leaked default route
- Gate network changes in CI
- Validate a routing policy in a lab
- Add checks to an existing containerlab lab

## Install

### Claude Code (Terminal)

```sh
claude mcp add netdryrun -- uvx netdryrun
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "netdryrun": {
      "command": "uvx",
      "args": [
        "netdryrun"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "netdryrun": {
      "command": "uvx",
      "args": [
        "netdryrun"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "netdryrun": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "netdryrun"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "netdryrun": {
      "command": "uvx",
      "args": [
        "netdryrun"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "netdryrun": {
      "command": "uvx",
      "args": [
        "netdryrun"
      ]
    }
  }
}
```

## Tools

- `dry_run`: Tests a network change in a lab and returns a pass or fail verdict with evidence.

## FAQ

### What does it require?

Linux or WSL2, Docker and containerlab, installed with pipx or uv.

### Which licence?

Apache-2.0, according to the README.

### Does it run on Windows?

Through WSL2; the docs show a wsl.exe setup for Claude Code on Windows.

### How do I add it to Claude Code?

Run claude mcp add netdryrun -- netdryrun mcp.

### Can I try it in a browser?

Yes, a trial runs in GitHub Codespaces with a free GitHub account.

### Is Netdryrun free?

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

### How do I add Netdryrun to Claude Code?

Run this command in your terminal: claude mcp add netdryrun -- uvx netdryrun

### What are the best alternatives to Netdryrun?

The closest alternatives to Netdryrun are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/netdryrun
