Needle MCP Server

Instructions

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"]
  }