NetBox MCP Setup & Guide

{
  "id": "io.github.mhajder/netbox-mcp",
  "type": "mcp-server",
  "version": "0.1.0",
  "displayName": "NetBox MCP",
  "description": "MCP server for NetBox DCIM/IPAM with read-only and dry-run modes",
  "repository": {
    "url": "https://github.com/mhajder/netbox-mcp",
    "source": "github"
  },
  "homepage": "https://github.com/mhajder/netbox-mcp",
  "distribution": {
    "packages": [
      {
        "registryType": "pypi",
        "identifier": "netbox-mcp",
        "version": "0.1.0",
        "runtimeHint": "uvx",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "NETBOX_URL",
            "description": "NetBox base URL (e.g., https://netbox.example.com)",
            "isRequired": true
          },
          {
            "name": "NETBOX_TOKEN",
            "description": "NetBox API token: v2 (nbt_<key>.<token>, NetBox 4.5+) or legacy v1",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "NETBOX_VERIFY_SSL",
            "description": "Verify SSL certificates (true/false)"
          },
          {
            "name": "NETBOX_TIMEOUT",
            "description": "Total time allowed for one NetBox request, retries included (seconds)"
          },
          {
            "name": "NETBOX_BRANCHING_ENABLED",
            "description": "Enable netbox-branching support: branch tools and the 'branch' argument (requires the netbox-branching plugin) (true/false)"
          },
          {
            "name": "NETBOX_BRANCH",
            "description": "Default netbox-branching branch (name or schema ID) for every call; requires NETBOX_BRANCHING_ENABLED=true"
          },
          {
            "name": "NETBOX_PLUGIN_DISCOVERY",
            "description": "Discover plugin object types from /api/core/object-types/ (true/false)"
          },
          {
            "name": "READ_ONLY_MODE",
            "description": "Hide all write tools (create, update, delete) (true/false)"
          },
          {
            "name": "DRY_RUN_MODE",
            "description": "Write tools only simulate changes and never modify NetBox (true/false)"
          },
          {
            "name": "DISABLED_TAGS",
            "description": "Comma-separated tool tags to disable (e.g. delete,graphql,branching)"
          },
          {
            "name": "LOG_LEVEL",
            "description": "Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)"
          },
          {
            "name": "RESPONSE_MAX_SIZE",
            "description": "Maximum tool response size in bytes (unset = unlimited)"
          },
          {
            "name": "RATE_LIMIT_ENABLED",
            "description": "Enable rate limiting"
          },
          {
            "name": "RATE_LIMIT_MAX_REQUESTS",
            "description": "Maximum requests per rate limit window"
          },
          {
            "name": "RATE_LIMIT_WINDOW_MINUTES",
            "description": "Rate limit window in minutes"
          },
          {
            "name": "TOOL_SEARCH_ENABLED",
            "description": "Enable FastMCP tool search transform"
          },
          {
            "name": "TOOL_SEARCH_STRATEGY",
            "description": "Tool search strategy (bm25 or regex)"
          },
          {
            "name": "TOOL_SEARCH_MAX_RESULTS",
            "description": "Maximum tool search results returned by search_tools"
          }
        ]
      },
      {
        "registryType": "pypi",
        "identifier": "netbox-mcp",
        "version": "0.1.0",
        "runtimeHint": "uvx",
        "transport": "streamable-http",
        "environmentVariables": [
          {
            "name": "NETBOX_URL",
            "description": "NetBox base URL (e.g., https://netbox.example.com)",
            "isRequired": true
          },
          {
            "name": "NETBOX_TOKEN",
            "description": "NetBox API token: v2 (nbt_<key>.<token>, NetBox 4.5+) or legacy v1",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "NETBOX_VERIFY_SSL",
            "description": "Verify SSL certificates (true/false)"
          },
          {
            "name": "NETBOX_TIMEOUT",
            "description": "Total time allowed for one NetBox request, retries included (seconds)"
          },
          {
            "name": "NETBOX_BRANCHING_ENABLED",
            "description": "Enable netbox-branching support: branch tools and the 'branch' argument (requires the netbox-branching plugin) (true/false)"
          },
          {
            "name": "NETBOX_BRANCH",
            "description": "Default netbox-branching branch (name or schema ID) for every call; requires NETBOX_BRANCHING_ENABLED=true"
          },
          {
            "name": "NETBOX_PLUGIN_DISCOVERY",
            "description": "Discover plugin object types from /api/core/object-types/ (true/false)"
          },
          {
            "name": "READ_ONLY_MODE",
            "description": "Hide all write tools (create, update, delete) (true/false)"
          },
          {
            "name": "DRY_RUN_MODE",
            "description": "Write tools only simulate changes and never modify NetBox (true/false)"
          },
          {
            "name": "DISABLED_TAGS",
            "description": "Comma-separated tool tags to disable (e.g. delete,graphql,branching)"
          },
          {
            "name": "LOG_LEVEL",
            "description": "Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)"
          },
          {
            "name": "RESPONSE_MAX_SIZE",
            "description": "Maximum tool response size in bytes (unset = unlimited)"
          },
          {
            "name": "RATE_LIMIT_ENABLED",
            "description": "Enable rate limiting"
          },
          {
            "name": "RATE_LIMIT_MAX_REQUESTS",
            "description": "Maximum requests per rate limit window"
          },
          {
            "name": "RATE_LIMIT_WINDOW_MINUTES",
            "description": "Rate limit window in minutes"
          },
          {
            "name": "TOOL_SEARCH_ENABLED",
            "description": "Enable FastMCP tool search transform"
          },
          {
            "name": "TOOL_SEARCH_STRATEGY",
            "description": "Tool search strategy (bm25 or regex)"
          },
          {
            "name": "TOOL_SEARCH_MAX_RESULTS",
            "description": "Maximum tool search results returned by search_tools"
          },
          {
            "name": "MCP_HTTP_PORT",
            "description": "Port for HTTP server (default: 8000)"
          },
          {
            "name": "MCP_TRANSPORT",
            "description": "MCP transport type (http for HTTP, stdio for stdio)"
          }
        ]
      },
      {
        "registryType": "oci",
        "identifier": "ghcr.io/mhajder/netbox-mcp:0.1.0",
        "transport": "streamable-http",
        "environmentVariables": [
          {
            "name": "NETBOX_URL",
            "description": "NetBox base URL (e.g., https://netbox.example.com)",
            "isRequired": true
          },
          {
            "name": "NETBOX_TOKEN",
            "description": "NetBox API token: v2 (nbt_<key>.<token>, NetBox 4.5+) or legacy v1",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "NETBOX_VERIFY_SSL",
            "description": "Verify SSL certificates (true/false)"
          },
          {
            "name": "NETBOX_TIMEOUT",
            "description": "Total time allowed for one NetBox request, retries included (seconds)"
          },
          {
            "name": "NETBOX_BRANCHING_ENABLED",
            "description": "Enable netbox-branching support: branch tools and the 'branch' argument (requires the netbox-branching plugin) (true/false)"
          },
          {
            "name": "NETBOX_BRANCH",
            "description": "Default netbox-branching branch (name or schema ID) for every call; requires NETBOX_BRANCHING_ENABLED=true"
          },
          {
            "name": "NETBOX_PLUGIN_DISCOVERY",
            "description": "Discover plugin object types from /api/core/object-types/ (true/false)"
          },
          {
            "name": "READ_ONLY_MODE",
            "description": "Hide all write tools (create, update, delete) (true/false)"
          },
          {
            "name": "DRY_RUN_MODE",
            "description": "Write tools only simulate changes and never modify NetBox (true/false)"
          },
          {
            "name": "DISABLED_TAGS",
            "description": "Comma-separated tool tags to disable (e.g. delete,graphql,branching)"
          },
          {
            "name": "LOG_LEVEL",
            "description": "Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)"
          },
          {
            "name": "RESPONSE_MAX_SIZE",
            "description": "Maximum tool response size in bytes (unset = unlimited)"
          },
          {
            "name": "RATE_LIMIT_ENABLED",
            "description": "Enable rate limiting"
          },
          {
            "name": "RATE_LIMIT_MAX_REQUESTS",
            "description": "Maximum requests per rate limit window"
          },
          {
            "name": "RATE_LIMIT_WINDOW_MINUTES",
            "description": "Rate limit window in minutes"
          },
          {
            "name": "TOOL_SEARCH_ENABLED",
            "description": "Enable FastMCP tool search transform"
          },
          {
            "name": "TOOL_SEARCH_STRATEGY",
            "description": "Tool search strategy (bm25 or regex)"
          },
          {
            "name": "TOOL_SEARCH_MAX_RESULTS",
            "description": "Maximum tool search results returned by search_tools"
          },
          {
            "name": "MCP_HTTP_PORT",
            "description": "Port for HTTP server (default: 8000)"
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.mhajder/netbox-mcp",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.mhajder%2Fnetbox-mcp/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}