NetBox MCP

Name: NetBox MCP
Author: mhajder

de mhajderversión 0.2.1i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.mhajder/netbox-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

MCP server for NetBox DCIM/IPAM with read-only and dry-run modes

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiAún sin medir★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio, Streamable HTTP
Categoría: Otros
Debes completar: NETBOX_URL, NETBOX_TOKEN

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: NETBOX_URL, NETBOX_TOKEN, NETBOX_VERIFY_SSL, NETBOX_TIMEOUT, NETBOX_BRANCHING_ENABLED, NETBOX_BRANCH, NETBOX_PLUGIN_DISCOVERY, READ_ONLY_MODE, DRY_RUN_MODE, DISABLED_TAGS, LOG_LEVEL, RESPONSE_MAX_SIZE, RATE_LIMIT_ENABLED, RATE_LIMIT_MAX_REQUESTS, RATE_LIMIT_WINDOW_MINUTES, TOOL_SEARCH_ENABLED, TOOL_SEARCH_STRATEGY, TOOL_SEARCH_MAX_RESULTS

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "netbox": {
      "command": "uvx",
      "args": [
        "netbox-mcp"
      ],
      "env": {
        "NETBOX_URL": "your-value",
        "NETBOX_TOKEN": "your-value",
        "NETBOX_VERIFY_SSL": "your-value",
        "NETBOX_TIMEOUT": "your-value",
        "NETBOX_BRANCHING_ENABLED": "your-value",
        "NETBOX_BRANCH": "your-value",
        "NETBOX_PLUGIN_DISCOVERY": "your-value",
        "READ_ONLY_MODE": "your-value",
        "DRY_RUN_MODE": "your-value",
        "DISABLED_TAGS": "your-value",
        "LOG_LEVEL": "your-value",
        "RESPONSE_MAX_SIZE": "your-value",
        "RATE_LIMIT_ENABLED": "your-value",
        "RATE_LIMIT_MAX_REQUESTS": "your-value",
        "RATE_LIMIT_WINDOW_MINUTES": "your-value",
        "TOOL_SEARCH_ENABLED": "your-value",
        "TOOL_SEARCH_STRATEGY": "your-value",
        "TOOL_SEARCH_MAX_RESULTS": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add netbox --env NETBOX_URL=your-value --env NETBOX_TOKEN=your-value --env NETBOX_VERIFY_SSL=your-value --env NETBOX_TIMEOUT=your-value --env NETBOX_BRANCHING_ENABLED=your-value --env NETBOX_BRANCH=your-value --env NETBOX_PLUGIN_DISCOVERY=your-value --env READ_ONLY_MODE=your-value --env DRY_RUN_MODE=your-value --env DISABLED_TAGS=your-value --env LOG_LEVEL=your-value --env RESPONSE_MAX_SIZE=your-value --env RATE_LIMIT_ENABLED=your-value --env RATE_LIMIT_MAX_REQUESTS=your-value --env RATE_LIMIT_WINDOW_MINUTES=your-value --env TOOL_SEARCH_ENABLED=your-value --env TOOL_SEARCH_STRATEGY=your-value --env TOOL_SEARCH_MAX_RESULTS=your-value -- uvx netbox-mcp

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "netbox": {
      "command": "uvx",
      "args": [
        "netbox-mcp"
      ],
      "env": {
        "NETBOX_URL": "your-value",
        "NETBOX_TOKEN": "your-value",
        "NETBOX_VERIFY_SSL": "your-value",
        "NETBOX_TIMEOUT": "your-value",
        "NETBOX_BRANCHING_ENABLED": "your-value",
        "NETBOX_BRANCH": "your-value",
        "NETBOX_PLUGIN_DISCOVERY": "your-value",
        "READ_ONLY_MODE": "your-value",
        "DRY_RUN_MODE": "your-value",
        "DISABLED_TAGS": "your-value",
        "LOG_LEVEL": "your-value",
        "RESPONSE_MAX_SIZE": "your-value",
        "RATE_LIMIT_ENABLED": "your-value",
        "RATE_LIMIT_MAX_REQUESTS": "your-value",
        "RATE_LIMIT_WINDOW_MINUTES": "your-value",
        "TOOL_SEARCH_ENABLED": "your-value",
        "TOOL_SEARCH_STRATEGY": "your-value",
        "TOOL_SEARCH_MAX_RESULTS": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "netbox": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "netbox-mcp"
      ],
      "env": {
        "NETBOX_URL": "your-value",
        "NETBOX_TOKEN": "your-value",
        "NETBOX_VERIFY_SSL": "your-value",
        "NETBOX_TIMEOUT": "your-value",
        "NETBOX_BRANCHING_ENABLED": "your-value",
        "NETBOX_BRANCH": "your-value",
        "NETBOX_PLUGIN_DISCOVERY": "your-value",
        "READ_ONLY_MODE": "your-value",
        "DRY_RUN_MODE": "your-value",
        "DISABLED_TAGS": "your-value",
        "LOG_LEVEL": "your-value",
        "RESPONSE_MAX_SIZE": "your-value",
        "RATE_LIMIT_ENABLED": "your-value",
        "RATE_LIMIT_MAX_REQUESTS": "your-value",
        "RATE_LIMIT_WINDOW_MINUTES": "your-value",
        "TOOL_SEARCH_ENABLED": "your-value",
        "TOOL_SEARCH_STRATEGY": "your-value",
        "TOOL_SEARCH_MAX_RESULTS": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

NETBOX_URL obligatorio env
NetBox base URL (e.g., https://netbox.example.com)
NETBOX_TOKEN secreto obligatorio env
NetBox API token: v2 (nbt_ . , NetBox 4.5+) or legacy v1
NETBOX_VERIFY_SSL env
Verify SSL certificates (true/false)
NETBOX_TIMEOUT env
Total time allowed for one NetBox request, retries included (seconds)
NETBOX_BRANCHING_ENABLED env
Enable netbox-branching support: branch tools and the 'branch' argument (requires the netbox-branching plugin) (true/false)
NETBOX_BRANCH env
Default netbox-branching branch (name or schema ID) for every call; requires NETBOX_BRANCHING_ENABLED=true
NETBOX_PLUGIN_DISCOVERY env
Discover plugin object types from /api/core/object-types/ (true/false)
READ_ONLY_MODE env
Hide all write tools (create, update, delete) (true/false)
DRY_RUN_MODE env
Write tools only simulate changes and never modify NetBox (true/false)
DISABLED_TAGS env
Comma-separated tool tags to disable (e.g. delete,graphql,branching)
LOG_LEVEL env
Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
RESPONSE_MAX_SIZE env
Maximum tool response size in bytes (unset = unlimited)
RATE_LIMIT_ENABLED env
Enable rate limiting
RATE_LIMIT_MAX_REQUESTS env
Maximum requests per rate limit window
RATE_LIMIT_WINDOW_MINUTES env
Rate limit window in minutes
TOOL_SEARCH_ENABLED env
Enable FastMCP tool search transform
TOOL_SEARCH_STRATEGY env
Tool search strategy (bm25 or regex)
TOOL_SEARCH_MAX_RESULTS env
Maximum tool search results returned by search_tools

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 7 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub mhajder, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Otrosi

Más estrellas que el 0% de los otros 32706 servidores de esta categoría
Publicado en el registro más recientemente que el 72% de los otros 32706 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 32706 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro NetBox MCP?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: NETBOX_URL, NETBOX_TOKEN

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.2.1) llegó al registro hace 14 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv), Docker en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Spec Driven Development, Remote Desktop Commander, Kanal Varna — drains, leaks & plumbing (Varna, BG)

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Spec Driven Development

de formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Se ejecuta en tu computadora★ 440MITActualizado hace 14 meses

Instalar

Remote Desktop Commander

de desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Se ejecuta en la nube★ 211Actualizado anteayer

Instalar

Kanal Varna — drains, leaks & plumbing (Varna, BG)

de kanalvarna.com

Drain unblocking, leak detection & plumbing in Varna, Bulgaria: services, prices, areas, contact

Se ejecuta en la nubeActualizado hoy

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

NetBox MCP Server

Give AI agents structured access to NetBox, your network source of truth

Installation · Tools · Configuration · Security

NetBox MCP Server is a Python-based Model Context Protocol (MCP) server that gives AI assistants structured access to NetBox - the source of truth for network infrastructure (DCIM and IPAM). A small set of generic tools covers all 139 core object types of NetBox 4.7 (and plugin types, if enabled), plus specialised tools for search, change logs, GraphQL, free IP/prefix/VLAN allocation, prefix utilization, free rack space, cable tracing and connecting, config rendering, custom scripts and (optionally) netbox-branching. Writes can be hidden entirely (read-only mode) or simulated (dry-run mode).

✨ Features

Core Features

Query any NetBox object type with filtering, ordering and pagination through one tool
Keep responses small with fields, omit and brief - the tools steer the model to use them
Search many object types at once, with explicit reporting of failed and truncated types
Read the change log (who changed what, when) and NetBox status/version/plugins
Run read-only GraphQL queries for nested data in one round trip
List free IPs, prefixes, VLANs and ASNs; trace cable paths; render device configs
Compute prefix utilization (as the NetBox UI shows it) and find racks with room for a device

Management Operations

Create, update and delete any object type, singly or in bulk (NetBox runs a bulk write as one transaction)
Allocate the next free IP, prefix, VLAN or ASN atomically
Connect ports with a cable, naming them by device and port name
Run NetBox custom scripts (changes rolled back unless commit is set)
Optionally stage changes in a netbox-branching branch instead of main
Describe an object type's writable fields and choices before writing

Advanced Capabilities

Read-only mode hides every write tool; dry-run mode turns every write into a preview
NetBox v2 (Bearer nbt_...) and legacy v1 (Token ...) API tokens
Plugin object type discovery (e.g. netbox_dns.zone)
Filter validation that rejects filters NetBox would silently ignore (__in, multi-hop lookups)
Retries on 429/5xx without ever replaying a create after a server error
Tag-based tool filtering, optional tool-search transform, rate limiting and response size limit
Bearer token authentication for HTTP transport
Multiple transport options (STDIO, SSE, HTTP)
Optional Sentry integration for error tracking

🚀 Installation

Prerequisites

Python 3.11 to 3.15
A NetBox instance, version 4.2 or newer. Features added later (omit, v2 tokens, /api/authentication-check/) are used when the server detects them
A NetBox API token with the permissions you want the assistant to have. The token is the real security boundary: a read-only token cannot write, whatever this server's settings are

Quick Install from PyPI

The easiest way to get started is to install from PyPI:

# Using UV (recommended)

uvx netbox-mcp

Or using pip

pip install netbox-mcp

Remember to configure the environment variables for your NetBox instance before running the server:

# Create environment configuration

export NETBOX_URL=https://netbox.example.com export NETBOX_TOKEN=nbt_your-key.your-token

Install from Source

Clone the repository:

git clone https://github.com/mhajder/netbox-mcp.git

cd netbox-mcp

Install dependencies:

# Using UV (recommended)

uv sync

Or using pip

pip install -e .

Configure environment variables:

cp .env.example .env

Edit .env with your NetBox URL and API token

Run the server:

# Using UV (recommended)

uv run netbox-mcp

Or using the installed command directly

netbox-mcp

Using Docker

A Docker image is available on GitHub Packages for easy deployment.

docker pull ghcr.io/mhajder/netbox-mcp:latest

Development Setup

For development with additional tools:

# Clone and install with development dependencies

git clone https://github.com/mhajder/netbox-mcp.git cd netbox-mcp uv sync --group dev

Run tests

uv run pytest

Run with coverage

uv run pytest --cov=src/

Run linting and formatting

uv run ruff check . uv run ruff format .

Run type checking

uv run ty check .

Setup prek hooks

uv run prek install

🔧 Configuration

Environment Variables

# NetBox MCP Server Environment Configuration

NetBox Connection Details

NETBOX_URL=https://netbox.example.com

API Token - v2 tokens (nbt_ . , NetBox 4.5+) are sent as "Bearer",

legacy v1 tokens as "Token"

NETBOX_TOKEN=nbt_your-key.your-token

SSL Configuration

NETBOX_VERIFY_SSL=true

Total time allowed for one NetBox request, retries included (seconds)

NETBOX_TIMEOUT=30

Branching (requires the netbox-branching plugin)

Set NETBOX_BRANCHING_ENABLED true to add the branch tools and the 'branch'

argument to every tool. Off by default - leave it off on a NetBox without the plugin

NETBOX_BRANCHING_ENABLED=false

Default branch (name or schema ID) used by every call; empty = main.

Requires NETBOX_BRANCHING_ENABLED=true

NETBOX_BRANCH=

Plugin Discovery

Set NETBOX_PLUGIN_DISCOVERY true to expose plugin models (e.g. netbox_dns.zone)

NETBOX_PLUGIN_DISCOVERY=false

Read-Only Mode

Set READ_ONLY_MODE true to hide all write tools (create, update, delete)

READ_ONLY_MODE=false

Dry-Run Mode

Set DRY_RUN_MODE true to make every write tool only simulate the change:

it returns the request it would send and never modifies NetBox

DRY_RUN_MODE=false

Disabled Tags

Comma-separated list of tags to disable tools for (empty by default)

Example: DISABLED_TAGS=delete,graphql,branching

DISABLED_TAGS=

Logging Configuration

LOG_LEVEL=INFO

Response Size Limit

Maximum tool response size in bytes; larger responses are truncated (empty = unlimited)

RESPONSE_MAX_SIZE=

Rate Limiting

Set RATE_LIMIT_ENABLED true to enable rate limiting

RATE_LIMIT_ENABLED=false RATE_LIMIT_MAX_REQUESTS=60 RATE_LIMIT_WINDOW_MINUTES=1

Tool Search Transform (Optional)

Set TOOL_SEARCH_ENABLED true to replace full tool listings with search_tools + call_tool

TOOL_SEARCH_ENABLED=false

Search strategy: bm25 (natural language) or regex (pattern match)

TOOL_SEARCH_STRATEGY=bm25

Maximum number of tools returned by search_tools

TOOL_SEARCH_MAX_RESULTS=5

Sentry Error Tracking (Optional)

Set SENTRY_DSN to enable error tracking and performance monitoring

SENTRY_DSN=https://your-key@o12345.ingest.us.sentry.io/6789

Optional Sentry configuration

SENTRY_TRACES_SAMPLE_RATE=1.0

SENTRY_SEND_DEFAULT_PII=false

SENTRY_ENVIRONMENT=production

SENTRY_RELEASE=1.2.3

SENTRY_PROFILE_SESSION_SAMPLE_RATE=1.0

SENTRY_PROFILE_LIFECYCLE=trace

SENTRY_ENABLE_LOGS=true

MCP Transport Configuration

Transport type: 'stdio' (default), 'sse' (Server-Sent Events), or 'http' (HTTP Streamable)

'streamable-http' is accepted as an alias for 'http'. Any other value stops

the server at startup.

MCP_TRANSPORT=stdio

HTTP Transport Settings (used when MCP_TRANSPORT=sse or MCP_TRANSPORT=http)

Host to bind the HTTP server (default: 127.0.0.1)

MCP_HTTP_HOST=127.0.0.1

Port to bind the HTTP server (default: 8000)

MCP_HTTP_PORT=8000

Optional bearer token for authentication (leave empty for no auth)

MCP_HTTP_BEARER_TOKEN=

Set NETBOX_TOKEN_PASSTHROUGH true to make every client authenticate with its own

NetBox API token (Authorization: Bearer ); NetBox then applies that user's

permissions. NETBOX_TOKEN is ignored. Cannot be combined with MCP_HTTP_BEARER_TOKEN

NETBOX_TOKEN_PASSTHROUGH=false

🧰 Available Tools

Object types are named app.model, as NetBox itself names them (dcim.device, ipam.prefix, virtualization.virtualmachine). API paths such as dcim/devices are accepted too. With branching enabled, every tool that reads or writes objects also takes an optional branch argument.

Objects (read)

Tool	Description
`netbox_list_object_types`	List supported object types and their endpoints (core and discovered plugin types)
`netbox_get_objects`	List objects of a type with `filters`, `fields`, `omit`, `brief`, `ordering`, `limit`, `offset`
`netbox_get_object`	Get one object by ID
`netbox_search_objects`	Free-text search (`q`) across several object types at once
`netbox_describe_object_type`	Writable fields of a type: data type, required, choices
`netbox_get_changelogs`	Change log entries, newest first

Specialised (read)

Tool	Description
`netbox_get_status`	NetBox version, plugins, workers, authenticated user and this server's modes
`netbox_graphql_query`	Read-only GraphQL query (mutations are rejected)
`netbox_get_available`	Free IPs / prefixes in a prefix or IP range, VLANs in a VLAN group, ASNs in an ASN range
`netbox_trace_cable`	Full cable path from an interface, front/rear/console/power port or circuit termination
`netbox_render_config`	Render a device's or VM's configuration from its config template
`netbox_get_prefix_utilization`	Utilization of up to 25 prefixes, computed as NetBox's UI does (child prefixes for containers, IPs and utilized ranges otherwise)
`netbox_find_rack_space`	Racks in a site, location or list with room for a device of a given height (counts both faces for full-depth devices, and reservations)
`netbox_list_branches`	List netbox-branching branches (only with `NETBOX_BRANCHING_ENABLED=true`)

Write

Tool	Description
`netbox_create_object`	Create one object
`netbox_update_object`	Partially update one object (PATCH)
`netbox_bulk_create_objects`	Create up to 500 objects in one transaction
`netbox_bulk_update_objects`	Update up to 500 objects in one transaction
`netbox_allocate_available`	Allocate the next free IP, prefix, VLAN or ASN
`netbox_connect_cable`	Cable ports together, given by ID or by device and port name; refuses ports that are already cabled
`netbox_run_script`	Run a custom script and wait for its log and output; `commit` defaults to false (`destructiveHint`)
`netbox_create_branch`	Create a netbox-branching branch (only with `NETBOX_BRANCHING_ENABLED=true`)
`netbox_delete_object`	Delete one object (`destructiveHint`)
`netbox_bulk_delete_objects`	Delete up to 500 objects in one transaction (`destructiveHint`)

Tool Tags

Every tool is tagged netbox plus a group tag, which `DI

Solo se muestra el principio; lee el resto en el repo

NetBox MCP

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Otrosi

Preguntas frecuentes

Alternativas

Spec Driven Development

Remote Desktop Commander

Kanal Varna — drains, leaks & plumbing (Varna, BG)

README del creador

NetBox MCP Server

✨ Features

Core Features

Management Operations

Advanced Capabilities

🚀 Installation

Prerequisites

Quick Install from PyPI

Or using pip

Install from Source

Or using pip

Edit .env with your NetBox URL and API token

Or using the installed command directly

Using Docker

Development Setup

Run tests

Run with coverage

Run linting and formatting

Run type checking

Setup prek hooks

🔧 Configuration

Environment Variables

NetBox Connection Details

API Token - v2 tokens (nbt_ . , NetBox 4.5+) are sent as "Bearer",

legacy v1 tokens as "Token"

SSL Configuration

Total time allowed for one NetBox request, retries included (seconds)

Branching (requires the netbox-branching plugin)

Set NETBOX_BRANCHING_ENABLED true to add the branch tools and the 'branch'

argument to every tool. Off by default - leave it off on a NetBox without the plugin

Default branch (name or schema ID) used by every call; empty = main.

Requires NETBOX_BRANCHING_ENABLED=true

Plugin Discovery

Set NETBOX_PLUGIN_DISCOVERY true to expose plugin models (e.g. netbox_dns.zone)

Read-Only Mode

Set READ_ONLY_MODE true to hide all write tools (create, update, delete)

Dry-Run Mode

Set DRY_RUN_MODE true to make every write tool only simulate the change:

it returns the request it would send and never modifies NetBox

Disabled Tags

Comma-separated list of tags to disable tools for (empty by default)

Example: DISABLED_TAGS=delete,graphql,branching

Logging Configuration

Response Size Limit

Maximum tool response size in bytes; larger responses are truncated (empty = unlimited)

Rate Limiting

Set RATE_LIMIT_ENABLED true to enable rate limiting

Tool Search Transform (Optional)

Set TOOL_SEARCH_ENABLED true to replace full tool listings with search_tools + call_tool

Search strategy: bm25 (natural language) or regex (pattern match)

Maximum number of tools returned by search_tools

Sentry Error Tracking (Optional)

Set SENTRY_DSN to enable error tracking and performance monitoring

SENTRY_DSN=https://your-key@o12345.ingest.us.sentry.io/6789

Optional Sentry configuration

SENTRY_TRACES_SAMPLE_RATE=1.0

SENTRY_SEND_DEFAULT_PII=false

SENTRY_ENVIRONMENT=production