needle_create_collection

Create a new document collection to organize related documents and enable semantic search across their contents. Returns a collection ID for managing documents.

Instructions

Create a new document collection in Needle for organizing and searching documents. A collection acts as a container for related documents and enables semantic search across its contents. Use this tool when you need to: - Start a new document organization - Group related documents together - Set up a searchable document repository Returns a collection ID that's required for subsequent operations. Choose a descriptive name that reflects the collection's purpose for better organization.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`name`	Yes	A clear, descriptive name for the collection that reflects its purpose and contents

Implementation Reference

src/needle_mcp/server.py:293-297 (handler)

Handler for the needle_create_collection tool. Validates input arguments, creates a new collection using the NeedleClient, and returns the generated collection ID.

elif name == "needle_create_collection":
    if not isinstance(arguments, dict) or "name" not in arguments:
        raise ValueError("Missing required parameter: 'name'")
    collection = client.collections.create(name=arguments["name"])
    result = {"collection_id": collection.id}

src/needle_mcp/server.py:108-128 (registration)

Registration of the needle_create_collection tool in the list_tools() function, including name, description, and input schema.

Tool(
    name="needle_create_collection",
    description="""Create a new document collection in Needle for organizing and searching documents. 
    A collection acts as a container for related documents and enables semantic search across its contents.
    Use this tool when you need to:
    - Start a new document organization
    - Group related documents together
    - Set up a searchable document repository
    Returns a collection ID that's required for subsequent operations. Choose a descriptive name that 
    reflects the collection's purpose for better organization.""",
    inputSchema={
        "type": "object",
        "properties": {
            "name": {
                "type": "string",
                "description": "A clear, descriptive name for the collection that reflects its purpose and contents"
            }
        },
        "required": ["name"]
    }
),

src/needle_mcp/server.py:118-127 (schema)

Input schema definition for the needle_create_collection tool, specifying a required 'name' string parameter.

inputSchema={
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "description": "A clear, descriptive name for the collection that reflects its purpose and contents"
        }
    },
    "required": ["name"]
}

Needle MCP Server