MCP server for inventory management system with tools for reading and writing items, locations, categories, tags, and spaces
Nage provides 18 tools with consistent naming (verb_noun pattern: list_, create_, update_, delete_) and basic descriptions. All tools have input schemas with typed parameters and descriptions. However, descriptions are minimal (10-50 chars, well below the 194-char baseline), lack context about when to use each tool, and omit dependency hints. Output schemas are not documented. Error handling is absent, no recovery guidance, no categorization of retryable vs fatal errors. Parameter descriptions are terse (e.g., 'Space ID' instead of 'The numeric ID of the space to query'). No tool annotations (readOnlyHint, destructiveHint) despite clear risk levels. Composition is sound, tools are single-responsibility and chainable via ID references.
Create a new category in a space
Create a new item in a space
Create a new location in a space
Create a new tag in a space
Delete a category
Delete an item
Delete a location
Delete a tag
Descriptions are critically short (10-50 chars vs 194-char baseline). Lack context on when to use each tool, prerequisites, and what is returned. LLMs cannot reliably select the right tool.
No output schemas documented. LLMs cannot plan downstream tool calls or extract required fields (e.g., what fields does get_item return? Does it include categoryId and locationId for chaining?).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | 2026-07-28+ | v2 |
Get details of a specific item
List all categories in a space
List all locations in a space
List all spaces accessible to the current user
List all tags in a space
Search items in a space by name or description
Update an existing category
Update an existing item
Update an existing location
Update an existing tag
No error handling guidance. Destructive tools (delete_*) lack confirmation or dry-run support. No recovery hints (e.g., 'Item not found. Try search_items() first.').
Tool annotations missing. Destructive tools (delete_*) should declare destructiveHint=true; read-only tools should declare readOnlyHint=true. Agents cannot infer safety without explicit hints.
Parameter descriptions are terse (e.g., 'Space ID' instead of 'The numeric ID of the space to query'). No format hints, constraints, or dependency documentation (e.g., 'parentId is optional; omit for top-level locations').