Needle
for LuumenAI
Semantic search over your runbooks and docs, with indexing changes held for approval
Needle keeps your runbooks, postmortems, and vendor docs in searchable collections. Luumen queries them during an incident and cites the source files, so an answer comes back with something you can open and check. Adding or removing files from a collection is a previewed step you approve. Luumen connects with an API key.
The Needle toolbox
16 tools: 10 read, 6 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadGet CollectionRetrieve details for a specific collection by its ID.
- ReadGet collection statsRetrieve statistics for a specific collection by its ID.
- ReadGet File Download URLGet a short-lived signed private download URL for a Needle file.
- ReadGet File Upload URLGet signed URLs for uploading local files to Needle.
- ReadGet local connectorRetrieve details of a local connector by its ID.
- ReadList Collection FilesList all files within a specific collection by its ID.
- ReadList CollectionsList collections.
- ReadList ConnectorsList connectors.
- ReadList Local ConnectorsList local connectors.
- ReadSearch CollectionPerform semantic search within a specific Needle collection and return ranked results with source references.
- WriteAdd files to a collectionAdd files to a collection by providing file URLs. Approval by default
- WriteAdd Files to Local ConnectorAdd files to a local connector by providing file metadata. Approval by default
- WriteCreate CollectionCreate a new collection. Approval by default
- WriteCreate Local ConnectorCreate a local connector that monitors specified folders on a device. Approval by default
- WriteDelete files from a collectionDelete files from a specific collection by providing file IDs. Approval by default
- WriteDelete files from local connectorDelete files from a local connector by filename or file IDs. Approval by default
One prompt, start to finish
What a governed Needle run looks like inside Luumen.
Questions
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Read actions answer immediately. Anything that writes — add files to a collection, add files to local connector, create collection, create local connector, and more — is shown as a plan and requires approval by default, including the 2 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Every call to Needle — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
Adobe Marketing Agent MCPAdobe Experience Platform context, sandbox switches, and async task status
AffindaRead parsed documents, collections, and annotations — change them with approval
Agent MailGive the agent its own mailbox for reading threads and sending updates
AI/ML APIInspect assistants, threads, and runs — and change them as approved stepsPut Needle to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.