Mentionable
Mentionable

enrich_reddit_thread

enrich_reddit_thread MCP tool: trigger Bright Data scrape of a Reddit thread. Charges 50 credits per enrichment on every plan, idempotent on in-progress scrapes, async (1-3 min).

Updated 2026-05-08

enrich_reddit_thread triggers a Bright Data scrape of a Reddit thread to pull the post body, top comments, upvotes and post date into the thread record. After the scrape lands, a follow-up get_reddit_thread (or list_reddit_threads) returns the full content so your agent can reason on it. Mentionable does not return a relevance score or suggested angle — the agent calling the MCP runs its own analysis.

When to use

Call it when list_reddit_threads returns a thread in NEW status and your agent decides it deserves a deeper read before engaging or dismissing. A typical loop: list threads with filters.status: ["NEW"], sort by score_desc, enrich the top N, poll get_reddit_thread until ENRICHED, then read content.postBody and content.topComments to draft a reply.

Requires member role minimum, customer role rejected.

Billing

Every plan is credit-based. enrich_reddit_thread charges 50 credits per enrichment on Growth, Pro and Agency, debited from the workspace's monthly credit pool (Growth 1,500, Pro 3,000, Agency 5,000 credits per month). Beyond the included pool, overage is billed at 0.02 € per credit, capped by the workspace's configurable monthly overage cap.

When a workspace is out of credits or capped by its overage limit, the call returns success: false with reason: "insufficient_credits" (see "Error" cases below) and no scrape is triggered. The check is bypassed in development (NODE_ENV=development).

Idempotency

If the thread is already in ENRICHING status, the call is a no-op: it returns success: true, alreadyInProgress: true and does not re-charge credits. This makes it safe to retry on transient errors. If the thread is ENRICHED or DELETED, the call will charge again and re-trigger. Call get_reddit_thread first if you want to avoid that.

Async

The scrape is asynchronous and typically lands in 1 to 3 minutes. Poll get_reddit_thread with a 30-second interval until status: "ENRICHED" (or "DELETED" if the post is gone on Reddit).

Input

Field Type Description
projectId string (CUID) Project the thread belongs to.
redditPostId string (CUID) Thread to enrich.

Response

Success: enrichment started

{
  "success": true,
  "alreadyInProgress": false,
  "thread": {
    "id": "clxred001",
    "url": "https://reddit.com/r/SEO/comments/abc123",
    "status": "ENRICHING"
  },
  "enrichment": {
    "mode": "credits",
    "charged": 50,
    "remaining": 1240
  },
  "message": "Enrichment started. Poll get_reddit_thread to watch for status: ENRICHED (typically 1-3 minutes)."
}

Success: already in progress (no charge)

{
  "success": true,
  "alreadyInProgress": true,
  "thread": {
    "id": "clxred001",
    "url": "https://reddit.com/r/SEO/comments/abc123",
    "status": "ENRICHING"
  },
  "message": "Enrichment already in progress. Poll get_reddit_thread to watch for status: ENRICHED."
}

Error: insufficient credits

The workspace is out of credits or capped by its monthly overage cap. reason is always insufficient_credits on every plan.

{
  "success": false,
  "error": "Not enough credits (12 remaining, need 50). Raise your monthly overage cap or wait for the next renewal.",
  "reason": "insufficient_credits",
  "plan": "GROWTH",
  "credits": {
    "required": 50,
    "remaining": 12,
    "tier": "GROWTH"
  }
}

Error: thread not found or cross-project

{
  "success": false,
  "error": "Reddit thread not found or does not belong to this project"
}

Tips and patterns

  • Always check success first, then alreadyInProgress to know whether you spent credits.
  • Every plan pays with credits (50 per enrichment). Agents should respect the workspace's monthly credit pool and avoid burning it on Reddit threads in a single run.
  • Cap your enrichment loop. Burning the whole monthly credit pool on Reddit threads when the user wanted competitor research is a real failure mode. Set an upper bound per agent run.
  • After enrichment, check content.isDeletedOnReddit. Dead leads should be marked SKIPPED via bulk_update_reddit_thread_status.
  • In development, enrichment returns { mode: "dev_bypass" } so you know no real budget was touched.
  • The credit check reads the same counters as the in-app feature: an MCP-driven enrichment loop will consume from the dashboard budget visible at Settings → Billing.

Related tools