get_category
Retrieve all values for a specific category key using its UUID. For example, get environment values such as Production, Dev, or Test.
Instructions
Get all values for a specific category key. Example: category 'Environment' may have values 'Production', 'Dev', 'Test'.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category_uuid | Yes | The UUID (extId) of the category |
Implementation Reference
- The handler function for 'get_category'. Calls v4 API to get category details by UUID via the prism config/categories endpoint.
async def handle_get_category( client: NutanixClient, arguments: dict[str, Any] ) -> dict[str, Any]: """Get category details using v4 prism API.""" category_uuid = arguments["category_uuid"] result = await client.v4_get( namespace="prism", path=f"config/categories/{category_uuid}", ) return result.get("data", result) - Input schema definition for 'get_category' tool. Requires 'category_uuid' (string) as the sole input.
{ "name": "get_category", "description": ( "Get all values for a specific category key. " "Example: category 'Environment' may have values 'Production', 'Dev', 'Test'." ), "inputSchema": { "type": "object", "properties": { "category_uuid": { "type": "string", "description": "The UUID (extId) of the category", }, }, "required": ["category_uuid"], }, }, ] - src/nutanix_mcp/tools/networking.py:292-299 (registration)Registration of 'get_category' in the NETWORKING_HANDLERS dispatch table, mapping the name to handle_get_category.
NETWORKING_HANDLERS: dict[str, Any] = { "list_subnets": handle_list_subnets, "get_subnet": handle_get_subnet, "list_images": handle_list_images, "get_image": handle_get_image, "list_categories": handle_list_categories, "get_category": handle_get_category, } - src/nutanix_mcp/tools/__init__.py:10-12 (registration)get_all_tools() aggregates NETWORKING_TOOLS (which includes get_category) into the global tool list.
def get_all_tools() -> list[dict]: """Return all registered tool definitions.""" return VM_TOOLS + CLUSTER_TOOLS + PE_TOOLS + REPORT_TOOLS + NETWORKING_TOOLS - src/nutanix_mcp/server.py:34-41 (registration)ALL_HANDLERS dictionary merges NETWORKING_HANDLERS, enabling the server to route 'get_category' calls to handle_get_category.
# Merge all handler dispatch tables ALL_HANDLERS: dict[str, Any] = { **VM_HANDLERS, **CLUSTER_HANDLERS, **PE_HANDLERS, **REPORT_HANDLERS, **NETWORKING_HANDLERS, }