MCP Integration Guide

RedditScanner exposes a JSON-RPC endpoint at /api/mcp for AI agent integration. This follows the Model Context Protocol (MCP) pattern for tool calling.

MCP access requires a Team plan.

Available Methods

scan_reddit

Find opportunities for a keyword on Reddit.

Parameters:

keyword (string, required) - Search keyword
subreddits (string[], optional) - Limit to these subreddits
min_score (number, optional) - Minimum score threshold

get_subreddits

Find relevant subreddits for a topic.

Parameters:

topic (string, required) - Topic or product description

analyze_thread

Deep analysis of a specific Reddit thread.

Parameters:

url (string, required) - Full Reddit thread URL
keyword (string, optional) - Keyword context for scoring

Example Request

curl -X POST https://redditscanner.ai/api/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: rs_your_key_here" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "scan_reddit",
    "params": {
      "keyword": "project management tool",
      "subreddits": ["SaaS", "startups"],
      "min_score": 40
    }
  }'

Example Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "keyword": "project management tool",
    "count": 8,
    "opportunities": [
      {
        "reddit_id": "xyz789",
        "title": "Best PM tool for a 10-person team?",
        "subreddit": "SaaS",
        "url": "https://reddit.com/r/SaaS/comments/xyz789/...",
        "score": 76,
        "age_hours": 5.2,
        "comment_count": 22,
        "upvotes": 18,
        "reason": "Posted today. Active discussion. Question post."
      }
    ]
  }
}

Agent Configuration

To configure your AI agent to use RedditScanner as an MCP tool, add it to your agent's tool configuration:

{
  "tools": [
    {
      "name": "redditscanner",
      "type": "mcp",
      "endpoint": "https://redditscanner.ai/api/mcp",
      "headers": {
        "x-api-key": "rs_your_key_here"
      },
      "methods": ["scan_reddit", "get_subreddits", "analyze_thread"]
    }
  ]
}