
Netdryrun
Test BGP and routing changes in a real containerlab lab before merge, with evidence
- Pricing
- Open source
- Platforms
- CLI, Linux, self-hosted
- Runs
- Locally
- Version
- 0.4.1
- Listing updated
- 3 days ago
About Netdryrun
Netdryrun is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add netdryrun -- uvx netdryrunAdd to claude_desktop_config.json
{
"mcpServers": {
"netdryrun": {
"command": "uvx",
"args": [
"netdryrun"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"netdryrun": {
"command": "uvx",
"args": [
"netdryrun"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"netdryrun": {
"type": "stdio",
"command": "uvx",
"args": [
"netdryrun"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"netdryrun": {
"command": "uvx",
"args": [
"netdryrun"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"netdryrun": {
"command": "uvx",
"args": [
"netdryrun"
]
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- dry_run
- Tests a network change in a lab and returns a pass or fail verdict with evidence.
What it does
- 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
Pricing
Open source
Apache-2.0 licensed
Prices change. Check netdryrun.com before you buy.
Netdryrun 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 to Netdryrun

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools