Needle MCP Server
OfficialEnables running new lead searches across Reddit (alongside Hacker News and forums) to surface relevant conversations, questions and pain points as Needle leads that can be reviewed, drafted replies for, and marked as handled.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
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/mcpThen 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 |
Today's best leads with a one-line "why reply", skips dismissed | |
Drafts replies for your top 5 leads | |
People leaving a competitor, with outreach angles | |
The week's pains and questions, clustered with quotes | |
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
Find high-intent Reddit conversations and manage lead workflows from MCP-compatible AI agents.
Find leads in Reddit, HN, X, Bluesky and Facebook group mentions, scored by AI, from your agent
Track what people say about your product on Reddit, X, Hacker News, GitHub and more
Live X/Twitter and Reddit research. 10 read-only MCP tools, Google/GitHub sign-in. Free tier.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to research customer voice by searching Reddit and extracting structured comments from supported community platforms via MCP.MIT
- AlicenseAqualityBmaintenanceMonitor keyword mentions across Reddit, Hacker News, X, and Bluesky, and triage AI-scored leads from your agent. Connects to the hosted RedReplier MCP server.191MIT
- FlicenseBqualityDmaintenanceEnables read-only monitoring of Reddit accounts and subreddits, including inbox, post performance, visibility checks, search, analytics, and market scans via MCP tools.18-
- AlicenseNot gradedqualityCmaintenanceEnables 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