needle_list_collections
Retrieve available document collections with IDs and metadata for managing Needle operations.
Instructions
List Needle collections. Returns maximum of 20 results. Get more results by increasing the offset. Returns detailed information including collection IDs, names, and creation dates. Use this tool when you need to: - Get an overview of available document collections - Find collection IDs for subsequent operations - Verify collection existence before performing operations The response includes metadata that's required for other Needle operations.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| offset | No | The offset to start listing from. Default is 0. |
Implementation Reference
- src/needle_mcp/server.py:281-292 (handler)Handler implementation for the needle_list_collections tool. Retrieves collections from Needle client, applies pagination with offset (max 20 results), and prepares JSON response.
if name == "needle_list_collections": offset = 0 if isinstance(arguments, dict) and "offset" in arguments: offset = int(arguments["offset"]) collections = client.collections.list() collection_data = [{"id": c.id, "name": c.name, "created_at": str(c.created_at)} for c in collections] # Apply pagination paginated_collections = collection_data[offset:offset + 20] result = {"collections": paginated_collections} - src/needle_mcp/server.py:96-106 (schema)Input schema for needle_list_collections tool defining optional offset parameter.
inputSchema={ "type": "object", "properties": { "offset": { "type": "number", "description": "The offset to start listing from. Default is 0.", "default": 0 } }, "required": [] } - src/needle_mcp/server.py:88-107 (registration)Registration of the needle_list_collections tool in the list_tools() function, including name, description, and input schema.
Tool( name="needle_list_collections", description="""List Needle collections. Returns maximum of 20 results. Get more results by increasing the offset. Returns detailed information including collection IDs, names, and creation dates. Use this tool when you need to: - Get an overview of available document collections - Find collection IDs for subsequent operations - Verify collection existence before performing operations The response includes metadata that's required for other Needle operations.""", inputSchema={ "type": "object", "properties": { "offset": { "type": "number", "description": "The offset to start listing from. Default is 0.", "default": 0 } }, "required": [] } ),