agents

The MCP endpoint.

A JSON-RPC endpoint that speaks Model Context Protocol. Point your agent at it and it can scan, score, and analyze Reddit on its own.

The endpoint lives at /api/mcp. Auth is the same x-api-key header used by the REST API. MCP access is included on the Team plan.

Available methods

scan_reddit

Find scored opportunities for a keyword.

keywordstring

reqThe search keyword

subredditsstring[]

Limit to these subreddits

min_scorenumber

Score floor (default 30)

get_subreddits

Suggest relevant subreddits for a product or topic.

topicstring

reqProduct or topic description

limitnumber

Max suggestions (default 20)

analyze_thread

Deep analysis of a specific Reddit thread — score, reply angles, risk flags.

urlstring

reqFull Reddit thread URL

keywordstring

Keyword context for scoring

Example request

bash

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": 60
    }
  }'

Example response

json

{
  "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",
        "score": 76,
        "age_hours": 5.2,
        "comment_count": 22,
        "reason": "Posted today. Active discussion. Question post."
      }
    ]
  }
}

Wire it to your agent

MCP clients like Claude Desktop, Cursor, and Continue can register the endpoint as a remote tool. Config shape varies by client, but the pattern is consistent:

json

{
  "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"]
    }
  ]
}

Prefer a typed SDK? The REST API does everything MCP does — see the API reference.

How scoring works