list_reddit_threads
list_reddit_threads MCP tool: Reddit threads cited by LLMs (visible citations + fan-out searches), with GEO signals, scraped content and the latest draft reply. Filter by status, subreddit, score and enrichment.
Updated 2026-04-26
list_reddit_threads
list_reddit_threads returns the Reddit threads that LLMs cite (visible citations) or run fan-out searches against, for a given project. Each row carries the GEO signal counts (citations, web searches, LLMs reached, prompt coverage), the scraped thread content (title, body, top comments, upvotes) when Bright Data has run, and the most recent in-app draft reply if one was generated. Use it to triage Reddit outreach for any agent workflow.
When to use
Reach for it when the user asks "where are LLMs sending people on Reddit?", "which Reddit threads should I engage with?", or "what's the queue of un-answered Reddit threads in my niche?". Default filters return actionable items only (NEW and ENRICHED), so a simple call surfaces a clean queue. The tool is intentionally opinion-free: relevance scoring and angle suggestions are not returned — your agent reads the post body and top comments and forms its own judgement with its own brand context.
Input
| Field | Type | Default | Description |
|---|---|---|---|
projectId |
string (CUID) | required | Project to query. |
cursor |
string | — | Pagination cursor. |
limit |
integer | 20 | 1 to 100. |
filters.status |
enum[] | ["NEW", "ENRICHED"] |
NEW, ENRICHING, ENRICHED, DELETED, COMMENTED, SKIPPED. |
filters.subredditContains |
string | — | Case-insensitive substring on subreddit. |
filters.minScore |
number | — | Minimum GEO score. |
filters.enrichedOnly |
boolean | — | Restrict to threads with Bright Data scrape completed. |
sortBy |
enum | score_desc |
score_desc, recent, citations_desc. |
Response
Each row is a Reddit thread with a signals block (GEO impact), a content block (scraped post body, top comments, upvotes — empty until enriched), a latestReply (the most recent in-app draft reply, or null), and current status. The top-level summary.byStatus lets the agent see the moderation backlog without a second call.
{
"data": [
{
"id": "clxred001",
"url": "https://reddit.com/r/SEO/comments/abc123",
"canonicalPath": "/r/seo/comments/abc123",
"subreddit": "seo",
"title": "How are you tracking AI visibility in 2026?",
"status": "ENRICHED",
"statusUpdatedAt": null,
"score": 18.4,
"signals": {
"citationCount": 4,
"webSearchCount": 7,
"totalSignals": 11,
"llmCount": 3,
"promptCount": 5
},
"content": {
"postDate": "2026-04-09T12:00:00.000Z",
"numUpvotes": 142,
"numComments": 38,
"postBody": "Curious what you're using to track LLM citations...",
"topComments": [
{ "comment": "We use Mentionable plugged into our agent.", "user": "marketingdude", "upvotes": 14 }
],
"isDeletedOnReddit": false
},
"enriched": true,
"enrichedAt": "2026-04-10T03:14:00.000Z",
"latestReply": {
"id": "clxrep001",
"content": "the ranking fluctuations you're seeing are probably because ChatGPT rotates sources based on prompt phrasing, not just content quality...",
"tone": "helpful",
"createdAt": "2026-04-10T03:14:30.000Z"
},
"createdAt": "2026-04-09T18:00:00.000Z",
"updatedAt": "2026-04-10T03:14:30.000Z"
}
],
"pageInfo": { "hasMore": true, "nextCursor": "clxred020", "totalCount": 64 },
"summary": {
"totalThreads": 87,
"byStatus": { "NEW": 22, "ENRICHED": 41, "COMMENTED": 8, "SKIPPED": 14, "DELETED": 2 }
}
}
Tips and patterns
- Sort by
score_descto surface the highest-impact threads (multi-LLM, multi-prompt, multi-citation). Sort bycitations_descwhen you want to focus on visible citations only. - A thread in
NEWstatus has signals but no scraped content yet. Callenrich_reddit_threadto pull the post body and top comments. latestReplyis the in-app Sonnet draft. Treat it as a seed: rewrite in your agent's voice rather than posting verbatim.- Filter
status: ["NEW"]to feed an enrichment loop; filterstatus: ["SKIPPED", "DELETED"]only when reviewing what was dismissed. - The
content.isDeletedOnRedditflag is set when Bright Data detects the post was removed on Reddit (community mismatch). Treat those as dead leads.
Related tools
- get_reddit_thread — fetch a single thread (poll enrichment status).
- enrich_reddit_thread — trigger Bright Data scrape for a
NEWthread. - bulk_update_reddit_thread_status — mark threads as commented, skipped or re-opened.
- list_llm_sources — see all domains LLMs cite, not just Reddit.