needle_get_collection_details
Fetch detailed metadata about a specific Needle collection to verify configuration, check status, and review attributes before performing operations.
Instructions
Fetch comprehensive metadata about a specific Needle collection. Provides detailed information about the collection's configuration, creation date, and current status. Use this tool when you need to: - Verify a collection's existence and configuration - Check collection metadata before operations - Get creation date and other attributes Requires a valid collection ID and returns detailed collection metadata. Will error if collection doesn't exist.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| collection_id | Yes | The unique collection identifier returned from needle_create_collection or needle_list_collections |
Implementation Reference
- src/needle_mcp/server.py:299-309 (handler)Handler implementation for the 'needle_get_collection_details' tool within the call_tool dispatcher function. Validates input, calls NeedleClient.collections.get(), and formats the response.
elif name == "needle_get_collection_details": if not isinstance(arguments, dict) or "collection_id" not in arguments: raise ValueError("Missing required parameter: 'collection_id'") collection = client.collections.get(arguments["collection_id"]) result = { "collection": { "id": collection.id, "name": collection.name, "created_at": str(collection.created_at) } } - src/needle_mcp/server.py:129-148 (registration)Tool registration in list_tools() including name, description, and input schema for 'needle_get_collection_details'.
Tool( name="needle_get_collection_details", description="""Fetch comprehensive metadata about a specific Needle collection. Provides detailed information about the collection's configuration, creation date, and current status. Use this tool when you need to: - Verify a collection's existence and configuration - Check collection metadata before operations - Get creation date and other attributes Requires a valid collection ID and returns detailed collection metadata. Will error if collection doesn't exist.""", inputSchema={ "type": "object", "properties": { "collection_id": { "type": "string", "description": "The unique collection identifier returned from needle_create_collection or needle_list_collections" } }, "required": ["collection_id"] } ), - src/needle_mcp/server.py:138-147 (schema)Input schema definition for the 'needle_get_collection_details' tool, specifying required 'collection_id' parameter.
inputSchema={ "type": "object", "properties": { "collection_id": { "type": "string", "description": "The unique collection identifier returned from needle_create_collection or needle_list_collections" } }, "required": ["collection_id"] }