Skip to main content
Glama
Needle MCP Server

Needle MCP Server

Official

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.

Add Needle to Cursor

  • 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.

Related MCP server: redreplier

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 support@useneedle.net.

License

MIT © VS NextGen Solutions.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to research customer voice by searching Reddit and extracting structured comments from supported community platforms via MCP.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Monitor keyword mentions across Reddit, Hacker News, X, and Bluesky, and triage AI-scored leads from your agent. Connects to the hosted RedReplier MCP server.
      19
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP-compatible AI apps to search, fetch, and synthesize tech community discussions from Hacker News, Lobsters, and optionally Reddit, without needing API keys for the primary sources.
      MIT