get_file_upload_url
Get File Upload URL
Generate signed upload URLs for uploading local or private files to Needle. After uploading a file to the signed URL, use the returned reference URL when adding the file to a collection.
Ask your agent in plain language. Each of these maps to a real tool on the server.
get_file_upload_url
Generate signed upload URLs for uploading local or private files to Needle. After uploading a file to the signed URL, use the returned reference URL when adding the file to a collection.
list_collection_files
List files in a collection with pagination support. Returns file metadata including name, size, content type, and indexing status.
delete_collection
Permanently delete a collection and all its indexed files. This action cannot be undone.
list_collections
List all document collections accessible to the authenticated user. Returns each collection's name, ID, creation date, and search query count.
list_connectors
List all configured data source connectors. Connectors automatically sync and index content from external sources like Google Drive, SharePoint, Notion, Slack, and others into collections.
get_collection
Retrieve details and statistics for a specific collection, including file counts, chunk counts, character counts, and indexing status breakdown.
create_collection
Create a new document collection. The authenticated user will be the owner of the created collection. Collections are the primary organizational unit for indexing and searching documents.
search_collection
Perform AI-powered semantic search across all documents in a collection. Needle automatically handles chunking, embedding, and reranking to return the most relevant text passages for the given query.
get_file_download_url
Prepare a downloadable file and return its signed download URL. The URL is short-lived; request a new one if you need to use it later.
delete_files_from_collection
Remove one or more files from a collection by their file IDs. Files managed by connectors (e.g. Google Drive sync) cannot be manually deleted.
add_files_to_collection
Add one or more files to a collection by providing a URL for each file. URLs can be public or private file reference URLs obtained via the **Get File Upload URL** tool. Files are automatically indexed for semantic search after being added.
list_connector_files
List files synchronized by a data source connector, including file IDs, source URLs, sizes, and timestamps. Use offset to retrieve another page.
get_collection_stats
Retrieve collection indexing statistics, including file counts, byte sizes, indexed chunks, characters, and users. Unknown byte sizes are returned as null.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Manage Needle document collections, add and remove indexed files, retrieve indexing statistics, and search document passages. Generate upload URLs for local files, download existing files, and inspect files synchronized by data source connectors.
Common questions about connecting Needle to AI agents with Metorial.