Terminal UI and CLI for NetBox — fast search, IPAM lookups, and device context. Includes MCP server for read-only tools over stdio.
Single tool 'nbox_get' has a clear verb-noun name and reasonable description (95 chars), but critical gaps undermine quality. The input schema is visible with 5 parameters, all typed as strings with descriptions. However, the output schema is completely undocumented, no return type, structure, or field definitions are visible in the source. This violates the baseline that 100% of A+ tools have documented return types. The tool accepts optional scope disambiguators (vrf, site, group) but lacks enum constraints or validation guidance. No error handling documentation exists, the tool provides no recovery guidance for invalid references or ambiguous lookups. The description mentions 'optional scope disambiguators' but does not explain when or why to use them, or what happens if multiple matches exist. READ_ONLY risk classification is correct but tool annotations (readOnlyHint) are not present in the schema.
MCP tool for object lookup by reference (slug/cidr/address/vid) with optional scope disambiguators (vrf/site/group)
Output schema completely undocumented. No return type, field structure, or example response visible. LLMs cannot plan downstream calls or extract required data.
No error handling guidance. Tool provides no recovery hints for invalid references, ambiguous lookups, or missing objects. LLMs cannot self-correct on failure.
Optional parameters (vrf, site, group) lack constraint documentation. No explanation of when to use them, mutual exclusivity, or behavior when multiple matches exist.
Tool description does not explain WHEN to call this tool vs alternatives, or what 'reference' formats are valid (slug vs CIDR vs address vs VID). Ambiguous for LLM selection.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | <=2025-11-25 | v2 |
No tool annotations present. READ_ONLY risk is declared in metadata but not in schema via readOnlyHint, limiting agent safety reasoning.