Search / io.github.mhajder/netbox-mcp
NetBox MCP
L0· runs locallyMCP server for NetBox DCIM/IPAM with read-only and dry-run modes
v0.2.0 · active · repository · website · descriptor JSON · versions
Search / io.github.mhajder/netbox-mcp
L0· runs locallyMCP server for NetBox DCIM/IPAM with read-only and dry-run modes
v0.2.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"netbox-mcp": {
"command": "uvx",
"args": [
"netbox-mcp==0.2.0"
],
"env": {
"NETBOX_URL": "${NETBOX_URL}",
"NETBOX_TOKEN": "${NETBOX_TOKEN}",
"NETBOX_VERIFY_SSL": "true",
"NETBOX_TIMEOUT": "30",
"NETBOX_BRANCHING_ENABLED": "false",
"NETBOX_PLUGIN_DISCOVERY": "false",
"READ_ONLY_MODE": "false",
"DRY_RUN_MODE": "false",
"LOG_LEVEL": "INFO",
"RATE_LIMIT_ENABLED": "false",
"RATE_LIMIT_MAX_REQUESTS": "60",
"RATE_LIMIT_WINDOW_MINUTES": "1",
"TOOL_SEARCH_ENABLED": "false",
"TOOL_SEARCH_STRATEGY": "bm25",
"TOOL_SEARCH_MAX_RESULTS": "5"
}
}
}
}claude mcp add netbox-mcp -e "NETBOX_URL=${NETBOX_URL}" -e "NETBOX_TOKEN=${NETBOX_TOKEN}" -e "NETBOX_VERIFY_SSL=true" -e "NETBOX_TIMEOUT=30" -e "NETBOX_BRANCHING_ENABLED=false" -e "NETBOX_PLUGIN_DISCOVERY=false" -e "READ_ONLY_MODE=false" -e "DRY_RUN_MODE=false" -e "LOG_LEVEL=INFO" -e "RATE_LIMIT_ENABLED=false" -e "RATE_LIMIT_MAX_REQUESTS=60" -e "RATE_LIMIT_WINDOW_MINUTES=1" -e "TOOL_SEARCH_ENABLED=false" -e "TOOL_SEARCH_STRATEGY=bm25" -e "TOOL_SEARCH_MAX_RESULTS=5" -- uvx netbox-mcp==0.2.0[mcp_servers.netbox-mcp]
command = "uvx"
args = ["netbox-mcp==0.2.0"]
env = { "NETBOX_URL" = "${NETBOX_URL}", "NETBOX_TOKEN" = "${NETBOX_TOKEN}", "NETBOX_VERIFY_SSL" = "true", "NETBOX_TIMEOUT" = "30", "NETBOX_BRANCHING_ENABLED" = "false", "NETBOX_PLUGIN_DISCOVERY" = "false", "READ_ONLY_MODE" = "false", "DRY_RUN_MODE" = "false", "LOG_LEVEL" = "INFO", "RATE_LIMIT_ENABLED" = "false", "RATE_LIMIT_MAX_REQUESTS" = "60", "RATE_LIMIT_WINDOW_MINUTES" = "1", "TOOL_SEARCH_ENABLED" = "false", "TOOL_SEARCH_STRATEGY" = "bm25", "TOOL_SEARCH_MAX_RESULTS" = "5" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"netbox-mcp": {
"type": "local",
"command": [
"uvx",
"netbox-mcp==0.2.0"
],
"enabled": true,
"environment": {
"NETBOX_URL": "{env:NETBOX_URL}",
"NETBOX_TOKEN": "{env:NETBOX_TOKEN}",
"NETBOX_VERIFY_SSL": "true",
"NETBOX_TIMEOUT": "30",
"NETBOX_BRANCHING_ENABLED": "false",
"NETBOX_PLUGIN_DISCOVERY": "false",
"READ_ONLY_MODE": "false",
"DRY_RUN_MODE": "false",
"LOG_LEVEL": "INFO",
"RATE_LIMIT_ENABLED": "false",
"RATE_LIMIT_MAX_REQUESTS": "60",
"RATE_LIMIT_WINDOW_MINUTES": "1",
"TOOL_SEARCH_ENABLED": "false",
"TOOL_SEARCH_STRATEGY": "bm25",
"TOOL_SEARCH_MAX_RESULTS": "5"
}
}
}
}{
"mcpServers": {
"netbox-mcp": {
"command": "uvx",
"args": [
"netbox-mcp==0.2.0"
],
"env": {
"NETBOX_URL": "${NETBOX_URL}",
"NETBOX_TOKEN": "${NETBOX_TOKEN}",
"NETBOX_VERIFY_SSL": "true",
"NETBOX_TIMEOUT": "30",
"NETBOX_BRANCHING_ENABLED": "false",
"NETBOX_PLUGIN_DISCOVERY": "false",
"READ_ONLY_MODE": "false",
"DRY_RUN_MODE": "false",
"LOG_LEVEL": "INFO",
"RATE_LIMIT_ENABLED": "false",
"RATE_LIMIT_MAX_REQUESTS": "60",
"RATE_LIMIT_WINDOW_MINUTES": "1",
"TOOL_SEARCH_ENABLED": "false",
"TOOL_SEARCH_STRATEGY": "bm25",
"TOOL_SEARCH_MAX_RESULTS": "5"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=netbox-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJuZXRib3gtbWNwPT0wLjIuMCJdLCJlbnYiOnsiTkVUQk9YX1VSTCI6IiR7TkVUQk9YX1VSTH0iLCJORVRCT1hfVE9LRU4iOiIke05FVEJPWF9UT0tFTn0iLCJORVRCT1hfVkVSSUZZX1NTTCI6InRydWUiLCJORVRCT1hfVElNRU9VVCI6IjMwIiwiTkVUQk9YX0JSQU5DSElOR19FTkFCTEVEIjoiZmFsc2UiLCJORVRCT1hfUExVR0lOX0RJU0NPVkVSWSI6ImZhbHNlIiwiUkVBRF9PTkxZX01PREUiOiJmYWxzZSIsIkRSWV9SVU5fTU9ERSI6ImZhbHNlIiwiTE9HX0xFVkVMIjoiSU5GTyIsIlJBVEVfTElNSVRfRU5BQkxFRCI6ImZhbHNlIiwiUkFURV9MSU1JVF9NQVhfUkVRVUVTVFMiOiI2MCIsIlJBVEVfTElNSVRfV0lORE9XX01JTlVURVMiOiIxIiwiVE9PTF9TRUFSQ0hfRU5BQkxFRCI6ImZhbHNlIiwiVE9PTF9TRUFSQ0hfU1RSQVRFR1kiOiJibTI1IiwiVE9PTF9TRUFSQ0hfTUFYX1JFU1VMVFMiOiI1In19"
}{
"servers": {
"netbox-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"netbox-mcp==0.2.0"
],
"env": {
"NETBOX_URL": "${NETBOX_URL}",
"NETBOX_TOKEN": "${NETBOX_TOKEN}",
"NETBOX_VERIFY_SSL": "true",
"NETBOX_TIMEOUT": "30",
"NETBOX_BRANCHING_ENABLED": "false",
"NETBOX_PLUGIN_DISCOVERY": "false",
"READ_ONLY_MODE": "false",
"DRY_RUN_MODE": "false",
"LOG_LEVEL": "INFO",
"RATE_LIMIT_ENABLED": "false",
"RATE_LIMIT_MAX_REQUESTS": "60",
"RATE_LIMIT_WINDOW_MINUTES": "1",
"TOOL_SEARCH_ENABLED": "false",
"TOOL_SEARCH_STRATEGY": "bm25",
"TOOL_SEARCH_MAX_RESULTS": "5"
}
}
}
}{
"mcpServers": {
"netbox-mcp": {
"command": "uvx",
"args": [
"netbox-mcp==0.2.0"
],
"env": {
"NETBOX_URL": "${NETBOX_URL}",
"NETBOX_TOKEN": "${NETBOX_TOKEN}",
"NETBOX_VERIFY_SSL": "true",
"NETBOX_TIMEOUT": "30",
"NETBOX_BRANCHING_ENABLED": "false",
"NETBOX_PLUGIN_DISCOVERY": "false",
"READ_ONLY_MODE": "false",
"DRY_RUN_MODE": "false",
"LOG_LEVEL": "INFO",
"RATE_LIMIT_ENABLED": "false",
"RATE_LIMIT_MAX_REQUESTS": "60",
"RATE_LIMIT_WINDOW_MINUTES": "1",
"TOOL_SEARCH_ENABLED": "false",
"TOOL_SEARCH_STRATEGY": "bm25",
"TOOL_SEARCH_MAX_RESULTS": "5"
}
}
}
}extensions:
"netbox-mcp":
enabled: true
name: "netbox-mcp"
type: stdio
cmd: "uvx"
args:
- "netbox-mcp==0.2.0"
envs:
"NETBOX_URL": "${NETBOX_URL}"
"NETBOX_TOKEN": "${NETBOX_TOKEN}"
"NETBOX_VERIFY_SSL": "true"
"NETBOX_TIMEOUT": "30"
"NETBOX_BRANCHING_ENABLED": "false"
"NETBOX_PLUGIN_DISCOVERY": "false"
"READ_ONLY_MODE": "false"
"DRY_RUN_MODE": "false"
"LOG_LEVEL": "INFO"
"RATE_LIMIT_ENABLED": "false"
"RATE_LIMIT_MAX_REQUESTS": "60"
"RATE_LIMIT_WINDOW_MINUTES": "1"
"TOOL_SEARCH_ENABLED": "false"
"TOOL_SEARCH_STRATEGY": "bm25"
"TOOL_SEARCH_MAX_RESULTS": "5"
timeout: 300
Placeholders to fill from your own secret store: ${NETBOX_TOKEN}. The registry never accepts secret values.
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknowndeps.known_vulns, deps.mcp_sdk_version, deps.resolvabledeps.dev does not know [email protected], [email protected]No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-1d-ago -unpinned-packages(1)
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
[email protected] PyPIthis version is not known to the dependency resolver
[email protected] PyPIthis version is not known to the dependency resolver
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
netbox-mcp | pypi | 0.2.0 | uvx | NETBOX_TOKEN |
netbox-mcp | pypi | 0.2.0 | uvx | NETBOX_TOKEN |
ghcr.io/mhajder/netbox-mcp:0.2.0 | oci | unpinned | – | NETBOX_TOKEN |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
{
"name": "io.github.mhajder/netbox-mcp",
"title": "NetBox MCP",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.2.0",
"packages": [
{
"version": "0.2.0",
"transport": {
"type": "stdio"
},
"identifier": "netbox-mcp",
"runtimeHint": "uvx",
"registryType": "pypi",
"environmentVariables": [
{
"name": "NETBOX_URL",
"isRequired": true,
"description": "NetBox base URL (e.g., https://netbox.example.com)"
},
{
"name": "NETBOX_TOKEN",
"isSecret": true,
"isRequired": true,
"description": "NetBox API token: v2 (nbt_<key>.<token>, NetBox 4.5+) or legacy v1"
},
{
"name": "NETBOX_VERIFY_SSL",
"default": "true",
"description": "Verify SSL certificates (true/false)"
},
{
"name": "NETBOX_TIMEOUT",
"default": "30",
"description": "Total time allowed for one NetBox request, retries included (seconds)"
},
{
"name": "NETBOX_BRANCHING_ENABLED",
"default": "false",
"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",
"default": "false",
"description": "Discover plugin object types from /api/core/object-types/ (true/false)"
},
{
"name": "READ_ONLY_MODE",
"default": "false",
"description": "Hide all write tools (create, update, delete) (true/false)"
},
{
"name": "DRY_RUN_MODE",
"default": "false",
"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",
"default": "INFO",
"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",
"default": "false",
"description": "Enable rate limiting"
},
{
"name": "RATE_LIMIT_MAX_REQUESTS",
"default": "60",
"description": "Maximum requests per rate limit window"
},
{
"name": "RATE_LIMIT_WINDOW_MINUTES",
"default": "1",
"description": "Rate limit window in minutes"
},
{
"name": "TOOL_SEARCH_ENABLED",
"default": "false",
"description": "Enable FastMCP tool search transform"
},
{
"name": "TOOL_SEARCH_STRATEGY",
"default": "bm25",
"description": "Tool search strategy (bm25 or regex)"
},
{
"name": "TOOL_SEARCH_MAX_RESULTS",
"default": "5",
"description": "Maximum tool search results returned by search_tools"
}
]
},
{
"version": "0.2.0",
"transport": {
"url": "http://localhost:{MCP_HTTP_PORT}/mcp",
"type": "streamable-http"
},
"identifier": "netbox-mcp",
"runtimeHint": "uvx",
"registryType": "pypi",
"environmentVariables": [
{
"name": "NETBOX_URL",
"isRequired": true,
"description": "NetBox base URL (e.g., https://netbox.example.com)"
},
{
"name": "NETBOX_TOKEN",
"isSecret": true,
"isRequired": true,
"description": "NetBox API token: v2 (nbt_<key>.<token>, NetBox 4.5+) or legacy v1"
},
{
"name": "NETBOX_VERIFY_SSL",
"default": "true",
"description": "Verify SSL certificates (true/false)"
},
{
"name": "NETBOX_TIMEOUT",
"default": "30",
"description": "Total time allowed for one NetBox request, retries included (seconds)"
},
{
"name": "NETBOX_BRANCHING_ENABLED",
"default": "false",
"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",
"default": "false",
"description": "Discover plugin object types from /api/core/object-types/ (true/false)"
},
{
"name": "READ_ONLY_MODE",
"default": "false",
"description": "Hide all write tools (create, update, delete) (true/false)"
},
{
"name": "DRY_RUN_MODE",
"default": "false",
"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",
"default": "INFO",
"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",
"default": "false",
"description": "Enable rate limiting"
},
{
"name": "RATE_LIMIT_MAX_REQUESTS",
"default": "60",
"description": "Maximum requests per rate limit window"
},
{
"name": "RATE_LIMIT_WINDOW_MINUTES",
"default": "1",
"description": "Rate limit window in minutes"
},
{
"name": "TOOL_SEARCH_ENABLED",
"default": "false",
"description": "Enable FastMCP tool search transform"
},
{
"name": "TOOL_SEARCH_STRATEGY",
"default": "bm25",
"description": "Tool search strategy (bm25 or regex)"
},
{
"name": "TOOL_SEARCH_MAX_RESULTS",
"default": "5",
"description": "Maximum tool search results returned by search_tools"
},
{
"name": "MCP_HTTP_PORT",
"default": "8000",
"description": "Port for HTTP server (default: 8000)"
},
{
"name": "MCP_TRANSPORT",
"value": "http",
"description": "MCP transport type: stdio, sse, or http (alias: streamable-http)"
}
]
},
{
"transport": {
"url": "http://localhost:{MCP_HTTP_PORT}/mcp",
"type": "streamable-http"
},
"identifier": "ghcr.io/mhajder/netbox-mcp:0.2.0",
"registryType": "oci",
"runtimeArguments": [
{
"name": "-p",
"type": "named",
"value": "{MCP_HTTP_PORT}:8000",
"isRequired": true,
"description": "Port mapping for HTTP transport"
}
],
"environmentVariables": [
{
"name": "NETBOX_URL",
"isRequired": true,
"description": "NetBox base URL (e.g., https://netbox.example.com)"
},
{
"name": "NETBOX_TOKEN",
"isSecret": true,
"isRequired": true,
"description": "NetBox API token: v2 (nbt_<key>.<token>, NetBox 4.5+) or legacy v1"
},
{
"name": "NETBOX_VERIFY_SSL",
"default": "true",
"description": "Verify SSL certificates (true/false)"
},
{
"name": "NETBOX_TIMEOUT",
"default": "30",
"description": "Total time allowed for one NetBox request, retries included (seconds)"
},
{
"name": "NETBOX_BRANCHING_ENABLED",
"default": "false",
"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",
"default": "false",
"description": "Discover plugin object types from /api/core/object-types/ (true/false)"
},
{
"name": "READ_ONLY_MODE",
"default": "false",
"description": "Hide all write tools (create, update, delete) (true/false)"
},
{
"name": "DRY_RUN_MODE",
"default": "false",
"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",
"default": "INFO",
"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",
"default": "false",
"description": "Enable rate limiting"
},
{
"name": "RATE_LIMIT_MAX_REQUESTS",
"default": "60",
"description": "Maximum requests per rate limit window"
},
{
"name": "RATE_LIMIT_WINDOW_MINUTES",
"default": "1",
"description": "Rate limit window in minutes"
},
{
"name": "TOOL_SEARCH_ENABLED",
"default": "false",
"description": "Enable FastMCP tool search transform"
},
{
"name": "TOOL_SEARCH_STRATEGY",
"default": "bm25",
"description": "Tool search strategy (bm25 or regex)"
},
{
"name": "TOOL_SEARCH_MAX_RESULTS",
"default": "5",
"description": "Maximum tool search results returned by search_tools"
},
{
"name": "MCP_HTTP_PORT",
"default": "8000",
"description": "Port for HTTP server (default: 8000)"
}
]
}
],
"repository": {
"url": "https://github.com/mhajder/netbox-mcp",
"source": "github"
},
"websiteUrl": "https://github.com/mhajder/netbox-mcp",
"description": "MCP server for NetBox DCIM/IPAM with read-only and dry-run modes"
}