Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/lance0/nbox/servenpx skills add lance0/nbox --skill servegit clone --depth 1 https://github.com/lance0/nboxWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00128 | $0.01542 |
| Opus 5 | $0.00064 | $0.00771 |
| Sonnet 5 | $0.00026 | $0.00308 |
| Haiku 4.5 | $0.00013 | $0.00154 |
Grade A, and why
nbox-serve scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 100 lines — stays where its author put it; the contents beside it link to each section on GitHub.
nbox serve (MCP server, read-only by default)
nbox serve exposes nbox's read layer as an MCP server. The tools reuse the
CLI's query + view layer, so they return the same JSON view models as the
equivalent nbox <cmd>. Read-only is the default — the write tools are always
listed but reject at call time unless writes are explicitly opted in (see below).
For the flags, run nbox serve --help — this skill is flag-free by design.
Two transports
- stdio (default). An MCP host launches
nbox serveas a subprocess and speaks JSON-RPC over stdin/stdout. JSON-RPC on stdout, logs on stderr; URL/token come from the active profile (same--profile/--configflags). Read-only by default; enable local single-user MCP writes withnbox serve --local-writesor[serve].local_writes = true, using the active profile token. - HTTP —
nbox serve --http 127.0.0.1:8080, same tools mounted at/mcp, loopback only withOrigin/Hostvalidation and an optional static bearer. Add--oidc-issuer <URL>+--audience <VALUE>for OAuth 2.1 resource-server mode: inbound IdP JWTs are validated on/mcp(alg allowlist,iss/aud/exp,nbox:readscope), a routable bind is allowed (TLS terminates in front), and Protected Resource Metadata is served at/.well-known/oauth-protected-resource. HTTP/mcpalso carries an audit log and an opt-in per-caller rate limit. This is read-only Pattern 3: the last hop to NetBox still uses the one local profile token, so the audit log is accountability, not per-user RBAC — trusted single-team read-only only.
The read tools
Each maps to a CLI read and returns the same view model:
| Tool | What it answers |
|---|---|
nbox_status |
Connection, capabilities, NetBox/Django/Python versions, token validity. Call first. |
nbox_search |
Cross-kind ranked search (one scope filter at a time). Find a reference, then nbox_get. |
nbox_get |
One object by kind + ref (vrf/site/group disambiguate). |
nbox_get_interface |
One interface on a device, with its cable-path trace. |
nbox_next_ip / nbox_next_prefix |
Next free address(es) / child block(s) — preview, reserves nothing. |
nbox_journal |
Operator journal entries for an object. |
nbox_history |
System audit log (create/update/delete, who + when); diff=true for full before/after. |
nbox_list_tags / nbox_tagged |
List tags; objects carrying a tag, across kinds. |
nbox_cache_clear |
Drop the local read cache (read-only w.r.t. NetBox). |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 3d ago First seen · 100 lines · 128 tokens per session scan A 61956648d09d
nbox-serve is a skill published in the GitHub repository lance0/nbox (11 stars, last pushed 21d ago), licensed Apache-2.0. It adds 128 tokens to every session and 1,542 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
dcim-devices
NetBox DCIM device CRUD with foreign-key name resolution and bulk operations.
dcim-interfaces
NetBox DCIM interface CRUD with composite addressing, VLAN/LAG name resolution, and cable trace.
generic-resource-actions
Shared CRUD pattern for NetBox resources whose entire CLI surface is generated from the OpenAPI schema.
ipam-prefixes
NetBox IPAM prefix CRUD plus available-ips and available-prefixes allocation helpers.
raw
Authenticated passthrough to any NetBox /api/ path that does not yet have a typed nbx command.
config
Manage nbx NetBox URL, token, and named contexts in /.config/nbx/config.toml.