Needle

Needle MCP server

Connect Claude, ChatGPT, Cursor and other MCP clients to your Needle leads: see who to reply to, read a lead in full, draft a reply in your brand voice, mark leads as handled, and run new searches across Reddit, Hacker News, forums and more.

In Claude: Needle is listed in Claude's connector directory.

• URL: https://api.useneedle.net/mcp (Streamable HTTP)
• Auth: sign in with your Needle account (OAuth), or an API key from Needle Settings → API & MCP. Growth and Scale plans, and the free 7-day trial (full access, no card).
• Changes: CHANGELOG.md. Tools and fields are never renamed or removed.
• Docs: useneedle.net/docs/mcp (tools, limits, errors) and the REST API

Set up

claude.ai and Claude Desktop: open Needle in Claude's connector directory, or go to Settings → Connectors, find Needle and click Connect. Sign in to Needle and choose Allow. If the directory is not available in your workspace, choose Add custom connector and paste https://api.useneedle.net/mcp.

ChatGPT: Plugins → Add → Add custom MCP server. Enter https://api.useneedle.net/mcp, keep Authentication on OAuth, tick I understand and want to continue, then Create and Connect. Sign in to Needle and choose Allow.

Claude Code

claude mcp add --transport http needle https://api.useneedle.net/mcp

Then run /mcp, pick needle and authenticate in the browser.

Cursor: use the button above, or add this to mcp.json and click Connect:

{
  "mcpServers": {
    "needle": { "url": "https://api.useneedle.net/mcp" }
  }
}

With an API key (Windsurf, scripts, or any client that cannot sign in):

{
  "mcpServers": {
    "needle": {
      "url": "https://api.useneedle.net/mcp",
      "headers": { "Authorization": "Bearer ndl_live_…" }
    }
  }
}

In Windsurf's mcp_config.json, name the URL serverUrl instead of url.

To debug a connection, run the MCP Inspector (npx @modelcontextprotocol/inspector), choose Streamable HTTP and enter the URL.

Apps you sign in with are listed in Needle under Settings → API & MCP → Connected apps, where you can disconnect them.

Skills

Ready-made workflows in Agent Skills format (skills/<name>/SKILL.md). Each states roughly how many API calls it uses.

Skill	What it does
daily-lead-shortlist	Today's best leads with a one-line "why reply", skips dismissed
five-replies-a-morning	Drafts replies for your top 5 leads
competitor-switchers	People leaving a competitor, with outreach angles
weekly-pain-report	The week's pains and questions, clustered with quotes
trend-to-content	Content ideas from trending problems and your leads

Needle never posts for you: drafts are text for you to review and post.

Errors

A failed tool call starts with a stable code (for example search_in_progress), then the details as JSON, including a doc_url into the error table and a request_id to quote to support.

Support

Open an issue in this repository, or email [email protected].

License

MIT © VS NextGen Solutions.