{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_nt5pw8t97qp3","handle":"mcp-netbox","url":"https://wellknown.network/agents/mcp-netbox","links":{"self":"https://wellknown.network/agents/mcp-netbox/record.json","html":"https://wellknown.network/agents/mcp-netbox","markdown":"https://wellknown.network/agents/mcp-netbox/record.md","api":"https://wellknown.network/api/v1/agents/mcp-netbox","status":"https://wellknown.network/api/v1/agents/mcp-netbox/status","claim":"https://wellknown.network/agents/mcp-netbox/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-netbox/claim.json","badge":"https://wellknown.network/agents/mcp-netbox/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-netbox/history","tools":"https://wellknown.network/api/v1/agents/mcp-netbox/tools"},"ard":{"identifier":"urn:air::server:mcp-netbox","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-netbox","summary":"MCP server exposing a NetBox DCIM/IPAM instance as read-only tools","description":"# mcp-netbox\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that\nexposes a [NetBox](https://netbox.io) DCIM/IPAM instance as a set of\n**read-only** tools. It lets an LLM (e.g. Claude, Copilot, or any MCP client)\nexplore sites, regions, locations, devices, interfaces, racks, IP prefixes, IP\naddresses, VLANs, VRFs, ASNs, circuits, providers, clusters, virtual machines,\ntenants, and DNS zones/records (via the `netbox-dns` plugin).\n\nBuilt with [FastMCP](https://github.com/jlowin/fastmcp) and `httpx`.\n\n## Features\n\n- **Read-only & safe** — every tool is annotated `read_only` / non-destructive /\n  idempotent. No writes are ever performed.\n- **Dedicated tools** for the most common resources, plus **generic tools**\n  (`netbox_list_objects`, `netbox_get_object`) that reach *any* NetBox API\n  endpoint.\n- **Two output formats** — human-readable Markdown tables or machine-readable\n  JSON, selectable per call.\n- **Pagination** — `limit` / `offset` on every list tool, with a hint about the\n  next page when more results exist.\n- **Rich filtering** — per-resource filters (site, region, status, VRF, VLAN,\n  manufacturer, …) plus a free-form `query_params` map on the generic tool.\n- **Config via file or environment** — `config.yaml` with environment\n  overrides for secrets.\n\n## Configuration\n\nThe server reads a `config.yaml` file. Copy the provided example and fill in\nyour values:\n\n```bash\ncp config.example.yaml config.yaml\n```\n\n```yaml\nnetbox:\n  url: https://netbox.example.com\n  token: Token your-api-token-here\n  timeout: 30000        # milliseconds\n  verify_ssl: true\n```\n\nThe config file is located in this order:\n\n1. The `--config` command-line argument (if provided).\n2. The path in the `NETBOX_CONFIG` environment variable.\n3. `config.yaml` in the current working directory.\n4. `config.yaml` next to the `mcp_netbox` package (the project root).\n\nEnvironment variables override the file values (handy for secrets):\n\n| Variable            | Meaning            …","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp","netbox","dcim","ipam","model-context-protocol"],"pricing":null,"endpoints":[{"url":"pypi:mcp-netbox","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.825,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-netbox","registry":"pypi","observedAt":"2026-10-28T12:22:53.410Z","publishedAt":"2026-10-02T02:05:07.294309Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-netbox","url":"https://pypi.org/project/mcp-netbox/","firstSeenAt":"2026-10-04T06:19:37.672Z","fetchedAt":"2026-10-28T12:21:18.728Z","normalizedAt":"2026-10-28T12:21:18.728Z"}]},"firstSeenAt":"2026-10-04T06:19:37.672Z","updatedAt":"2026-10-28T12:22:53.410Z"}