# Netra

Netra is an MCP server for Claude Code that connects an agent to Linux and Kubernetes network diagnostics and emergency controls. Its tools can inspect traffic and apply temporary deny rules.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: zyvorai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/zyvorai/zyvor-netra
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/netra

## What it does

Netra exposes network observability and emergency controls for Linux and Kubernetes through 190 MCP tools. An agent can investigate kernel packet drops, inspect network paths and capture filtered traffic. Deny rules have a lease and return to observation automatically when it expires.

The container runs as `ghcr.io/zyvorai/netra-mcp:0.32.0`. Setup requires Docker, a Netra server address in `NETRA_URL`, an API key in `NETRA_API_KEY`, and values for `NETRA_MCP_ALLOW_MUTATIONS` and `NETRA_MCP_ACTOR`. The mutation setting gates changes. Netra works without Cilium; Cilium and Hubble integrations are optional.

## Requirements
- Needs: Docker
- Environment variables: `NETRA_URL`, `NETRA_API_KEY`, `NETRA_MCP_ALLOW_MUTATIONS`, `NETRA_MCP_ACTOR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Kubernetes

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env NETRA_URL=<NETRA_URL> --env NETRA_API_KEY=<NETRA_API_KEY> --env NETRA_MCP_ALLOW_MUTATIONS=<NETRA_MCP_ALLOW_MUTATIONS> --env NETRA_MCP_ACTOR=<NETRA_MCP_ACTOR> --transport stdio netra -- docker run -i --rm -e NETRA_URL -e NETRA_API_KEY -e NETRA_MCP_ALLOW_MUTATIONS -e NETRA_MCP_ACTOR ghcr.io/zyvorai/netra-mcp:0.32.0
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add netra --env NETRA_URL=<NETRA_URL> --env NETRA_API_KEY=<NETRA_API_KEY> --env NETRA_MCP_ALLOW_MUTATIONS=<NETRA_MCP_ALLOW_MUTATIONS> --env NETRA_MCP_ACTOR=<NETRA_MCP_ACTOR> -- docker run -i --rm -e NETRA_URL -e NETRA_API_KEY -e NETRA_MCP_ALLOW_MUTATIONS -e NETRA_MCP_ACTOR ghcr.io/zyvorai/netra-mcp:0.32.0
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "netra": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "NETRA_URL",
                "-e",
                "NETRA_API_KEY",
                "-e",
                "NETRA_MCP_ALLOW_MUTATIONS",
                "-e",
                "NETRA_MCP_ACTOR",
                "ghcr.io/zyvorai/netra-mcp:0.32.0"
            ],
            "env": {
                "NETRA_URL": "<NETRA_URL>",
                "NETRA_API_KEY": "<NETRA_API_KEY>",
                "NETRA_MCP_ALLOW_MUTATIONS": "<NETRA_MCP_ALLOW_MUTATIONS>",
                "NETRA_MCP_ACTOR": "<NETRA_MCP_ACTOR>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "netra": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "NETRA_URL",
                "-e",
                "NETRA_API_KEY",
                "-e",
                "NETRA_MCP_ALLOW_MUTATIONS",
                "-e",
                "NETRA_MCP_ACTOR",
                "ghcr.io/zyvorai/netra-mcp:0.32.0"
            ],
            "env": {
                "NETRA_URL": "<NETRA_URL>",
                "NETRA_API_KEY": "<NETRA_API_KEY>",
                "NETRA_MCP_ALLOW_MUTATIONS": "<NETRA_MCP_ALLOW_MUTATIONS>",
                "NETRA_MCP_ACTOR": "<NETRA_MCP_ACTOR>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e NETRA_URL=<NETRA_URL> -e NETRA_API_KEY=<NETRA_API_KEY> -e NETRA_MCP_ALLOW_MUTATIONS=<NETRA_MCP_ALLOW_MUTATIONS> -e NETRA_MCP_ACTOR=<NETRA_MCP_ACTOR> netra docker run -i --rm -e NETRA_URL -e NETRA_API_KEY -e NETRA_MCP_ALLOW_MUTATIONS -e NETRA_MCP_ACTOR ghcr.io/zyvorai/netra-mcp:0.32.0
```
Replace <…> with your own values

## When to use it
- trace why the kernel dropped packets
- investigate network path delays and congestion
- capture filtered traffic from a node
- apply a temporary deny rule that later returns to observation

## Example prompts
- Find the cause of packet drops on this Linux node.
- Investigate network delays in this Kubernetes cluster and show the related flows.
- Block connections to this address for a limited time.

## Similar
- [cilium-expert](https://affpapa.org/en/nevibecode/skills/cilium-expert.md) — skill · 253 installs
- [ebpf-observability](https://affpapa.org/en/nevibecode/skills/ebpf-observability.md) — skill · 355 installs
- [otel-profiles](https://affpapa.org/en/nevibecode/skills/otel-profiles.md) — skill · ★ 126 repo stars
- [littlesnitch-linux](https://affpapa.org/en/nevibecode/skills/littlesnitch-linux.md) — skill · 526 installs
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12142 repo stars
- [beyla](https://affpapa.org/en/nevibecode/skills/beyla.md) — skill · 5200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
