Get started

Needle for AI agents

Needle provides retrieval-augmented generation tools for semantic search across a team's own documents and data, powering internal knowledge assistants and support bots. Connect it once through Arc0, and your agent, or Claude, ChatGPT and Cursor, can use it through one MCP endpoint, limited to what each user approved.

Connect NeedleSee the 16 actions ↓
AI and modelsAPI keyMCP + RESTneedle-ai.com
AUDIT LOG · NEEDLEPOLICY: acme-support
09:41:07 · claude · u_8f2read
needle.list_connectors
List Connectors✓ allowed · 212ms
09:41:08 · claude · u_8f2read
needle.get_collection
Get Collection✓ allowed · 164ms
09:41:09 · claude · u_8f2write
needle.create_collection
Create Collection✓ approved · approved by user
09:41:12 · claude · u_8f2destructive
needle.delete_files_from_collection
Delete files from a collection✕ blocked · policy: deny
EVERY NEEDLE CALL, ON THE RECORD
01 · USE CASES

What agents do in Needle.

01

Search a document collection

Run a semantic search across a collection to find relevant passages for a question.

02

Add files to a collection

Upload new documents into a collection so they become searchable for future retrieval queries.

03

Approve before deleting files

Require approval before deleting files from a collection, since it removes them from future search results.

02 · ACTIONS

16 Needle actions, graded by risk.

Every Needle action is tagged read, write or destructive, so one policy covers the whole app and new actions inherit the right default.

read

10

Look things up. Allowed by default.

  • needle.get_collection
    Get Collection
  • needle.list_connectors
    List Connectors
  • needle.list_collections
    List Collections
  • needle.search_collection
    Search Collection
  • needle.get_file_upload_url
    Get File Upload URL
  • needle.get_local_connector
    Get local connector
  • needle.get_collection_stats
    Get collection stats
  • needle.get_file_download_url
    Get File Download URL
  • needle.list_collection_files
    List Collection Files
  • needle.list_local_connectors
    List Local Connectors

write

4

Create and change things. Allow, or ask the user first.

  • needle.create_collection
    Create Collection
  • needle.create_local_connector
    Create Local Connector
  • needle.add_files_to_collection
    Add files to a collection
  • needle.add_files_to_local_connector
    Add Files to Local Connector

destructive

2

Delete, cancel or archive. Ask first, or deny outright.

  • needle.delete_files_from_collection
    Delete files from a collection
  • needle.delete_files_from_local_connector
    Delete files from local connector
03 · HOW IT WORKS

Needle in three steps.

  1. 01Your users connect NeedleThey add their Needle api key on Arc0 Connect, under your brand. It goes straight into the vault.
  2. 02You set the rulesReads run, writes like “create Collection” can wait for the user, and “delete files from a collection” can be denied outright.
  3. 03Any agent can actYour agent calls Needle through the Arc0 SDK or MCP, and so can Claude, ChatGPT and Cursor. Every call lands on the audit log.
POLICY.TS
await arc0.policies.set('needle', {
  read: 'allow',
  write: 'ask',        // create_collection
  destructive: 'deny',  // delete_files_from_collection
})

# Claude Code: the same connection, one URL
$ claude mcp add --transport http arc0 \
    https://mcp.arc0.ai/u/u_8f2
04 · AUTH AND DATA

How Needle connects.

Users add their Needle api key on Arc0 Connect. It is encrypted in the vault, never shown to the model, and each user can rotate or revoke it at any time.

The same Needle connection serves your agent over MCP and your own backend over REST and the proxy, so a user connects once. How Arc0 handles credentials →

AUTH
API key
CREDENTIALS
Per-tenant encrypted vault
MODEL SEES
Results only, never credentials
AUDIT LOG
Every call, on every plan
05 · WORKS WITH

Use Needle from any agent.

Claude
ChatGPT
Cursor
Codex
VS Code
OpenAI Agents SDK
Claude Agent SDK
Vercel AI SDK
Mastra
LangGraph
06 · RELATED

More ai and models apps.

Perplexity AI9 actionsAffinda119 actionsAgent Mail5 actionsAI/ML API30 actionsAivoov1 actionsAll Images AI7 actionsAltText.ai10 actionsAltTextLab2 actions
ALL AI AND MODELS APPS →
07 · FAQ

Needle and Arc0, answered.

Q01

Can I use Needle with Claude, ChatGPT or Cursor?

Yes. Connect Needle to Arc0 once, then add your Arc0 MCP URL to Claude, ChatGPT, Cursor, Claude Code or any other remote-MCP client. Each assistant only gets the Needle actions you allow.

Q02

How do users connect Needle?

Users add their Needle api key on Arc0 Connect. It is encrypted in the vault, never shown to the model, and each user can rotate or revoke it at any time.

Q03

Which Needle actions can my agent take?

16 in total: 10 read, 4 write and 2 destructive, such as “create Collection”. Your policies decide which of them each agent may call.

Q04

Can I stop my agent from deleting things in Needle?

Yes. Actions like “delete files from a collection” are graded destructive. Set destructive actions to deny, or to ask so the user approves each one, and blocked calls still show up on the audit log.

Q05

Can my own backend call Needle too?

Yes. The same Needle connection is available over REST and through the Arc0 proxy, so your product and your agent share one connection per user.

Get started

Plug Needle into your agent.

Your users connect Needle once, under your brand. Your agent gets 16 actions behind your policies, with every call on the record.

Connect NeedleBrowse all apps →

Free to build · MCP + REST · Audit log on every plan