Needle MCP Server

Official

needle_add_file

Add a new document to a Needle collection by providing a URL for download. Supports multiple file formats including: - PDF documents - Microsoft Word files (DOC, DOCX) - Plain text files (TXT) - Web pages (HTML)

The document will be: 1. Downloaded from the provided URL 2. Processed for text extraction 3. Indexed for semantic search Use this tool when you need to: - Add new documents to a collection - Make documents searchable - Expand your knowledge base Important: Documents require processing time before they're searchable. Check processing status using needle_list_files before searching new content.

Input Schema

NameRequiredDescriptionDefault
collection_idYesThe unique collection identifier where the file will be added
nameYesA descriptive filename that will help identify this document in results
urlYesPublic URL where the document can be downloaded from

Input Schema (JSON Schema)

{ "properties": { "collection_id": { "description": "The unique collection identifier where the file will be added", "type": "string" }, "name": { "description": "A descriptive filename that will help identify this document in results", "type": "string" }, "url": { "description": "Public URL where the document can be downloaded from", "type": "string" } }, "required": [ "collection_id", "name", "url" ], "type": "object" }