FindLeadsBot MCP Server

MCP server that connects Claude (or any MCP host) to the FindLeadsBot API for Reddit lead discovery, AI intent scoring, and reply drafting.

Quick Start

npx findleadsbot-mcp

Get your API key at findleadsbot.com/settings/api.

Configuration

Claude Code

Add to .mcp.json in your project root (or ~/.claude/.mcp.json for global access):

{
  "mcpServers": {
    "findleadsbot": {
      "command": "npx",
      "args": ["-y", "findleadsbot-mcp@latest"],
      "env": {
        "FINDLEADSBOT_API_KEY": "flb_your_key_here"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "findleadsbot": {
      "command": "npx",
      "args": ["-y", "findleadsbot-mcp@latest"],
      "env": {
        "FINDLEADSBOT_API_KEY": "flb_your_key_here"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | FINDLEADSBOT_API_KEY | Yes* | — | Your API key (starts with flb_) | | FINDLEADSBOT_BASE_URL | No | https://findleadsbot.com | API base URL |

*Only required for find_leads, analyze_post, and draft_reply. The score_post tool works without a key.

Tools

find_leads

Discover Reddit leads with AI-powered intent scoring. Costs 1 credit.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | keywords | string[] | Yes | Search keywords (1-5) | | subreddits | string[] | No | Limit to these subreddits | | intent | "all" \| "buying" \| "pain_point" \| "other" | No | Filter by intent type | | time_filter | "hour" \| "day" \| "week" \| "month" \| "year" \| "all" | No | Time range | | limit | number | No | Max leads (default 50, max 100) | | include_analysis | boolean | No | Include AI intent analysis (default true) |

Returns: Array of leads with intent classification, pain points, and metadata.

analyze_post

Analyze a single Reddit post URL for buying intent, pain points, and urgency. Costs 1 credit.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | url | string | Yes | Reddit post URL |

Returns: Analysis with intent type, confidence, pain points, buying signals, and urgency level.

score_post

Score a post for lead quality using rule-based signals. Free (no API call, instant).

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | title | string | Yes | Post title | | body | string | No | Post body/selftext | | created_utc | number | No | Unix timestamp of creation | | num_comments | number | No | Comment count | | score | number | No | Reddit score (upvotes - downvotes) | | has_buying_intent | boolean | No | AI-detected buying intent | | has_pain_point | boolean | No | AI-detected pain point |

Returns:

{
  "total": 78,
  "intentScore": 32,
  "recencyScore": 25,
  "engagementScore": 6,
  "competitorScore": 15,
  "signals": ["looking for", "tired of", "mentions: gummysearch"],
  "tier": "hot",
  "isHighIntent": true
}

Scoring breakdown:

• Intent (0-40): Matches against 25 high-intent and 16 medium-intent signal phrases
• Recency (0-25): Based on post age (6h=25, 24h=20, 48h=15, 1w=10, 1mo=5)
• Engagement (0-20): 1 point per 3 comments (max 12) + 1 per 25 upvotes (max 8)
• Competitor (0-15): Bonus for mentions of known competitors

Tiers: hot (60+ total or 30+ intent with 15+ recency), warm (35+ total or 20+ intent), cold (below thresholds)

draft_reply

Generate a helpful, human-sounding Reddit reply. Costs 1 credit.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | post_title | string | Yes | Title of the post | | post_body | string | No | Body/selftext | | subreddit | string | Yes | Target subreddit | | product_name | string | Yes | Your product name | | product_description | string | Yes | What your product does | | problems_solved | string[] | Yes | Problems your product solves |

Returns: AI-generated reply text that addresses the post naturally.

How It Works

Claude Code / Claude Desktop / Any MCP Host
    | (MCP protocol over stdio)
findleadsbot-mcp
    | (HTTPS + Bearer auth)
FindLeadsBot API

Exception: score_post runs locally — pure function, no network call, no credits used.

License

MIT