# Redditoro: MCP & API access

Redditoro exposes a Model Context Protocol (MCP) server so AI clients like Claude
Code, Claude Desktop, and Cursor can operate your Redditoro account from a prompt.
The same endpoint speaks plain JSON-RPC 2.0 over HTTP, so you can also call it
directly with curl or any HTTP library.

## Endpoint

    POST https://redditoro.com/api/mcp

Streamable HTTP transport, JSON-RPC 2.0. It implements: initialize, tools/list,
tools/call, and ping.

## Authentication

Every request needs a personal key in the Authorization header:

    Authorization: Bearer sbk_YOUR_KEY

Create and manage keys on the "MCP / API access" page in the dashboard
(https://redditoro.com/dashboard/mcp). A key is shown once at creation, copy it
then. Each key is scoped to your account and its active project; revoke it any
time and connected clients stop working immediately. MCP tool calls require the
Growth plan or above.

## Connect Claude Code

    claude mcp add --transport http redditoro \
      https://redditoro.com/api/mcp \
      --header "Authorization: Bearer sbk_YOUR_KEY"

## Connect Claude Desktop

Settings → Developer → Edit Config, add to mcpServers, then restart:

    {
      "mcpServers": {
        "redditoro": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://redditoro.com/api/mcp",
            "--header", "Authorization: Bearer sbk_YOUR_KEY"]
        }
      }
    }

## Connect Cursor

Add to ~/.cursor/mcp.json (or a project's .cursor/mcp.json):

    {
      "mcpServers": {
        "redditoro": {
          "url": "https://redditoro.com/api/mcp",
          "headers": { "Authorization": "Bearer sbk_YOUR_KEY" }
        }
      }
    }

## Tools

- **find_subreddits**: Find the best subreddits to reach a product's target
  customers, ranked by fit with a reason for each.
  Params: description (string, optional; defaults to your configured product).
- **subreddit_rules**: Fetch a subreddit's rules and get a promo-safety read
  (promo-ok / stories-only / no-promo) plus the safest angle.
  Params: subreddit (string, required), e.g. "SaaS".
- **generate_content_plan**: Generate a 7-day Reddit content plan (comment days
  and post days) from your configured product and subreddits.
  Params: none.
- **check_ai_visibility**: Ask an AI a buyer-style question and check whether a
  product is mentioned in the answer.
  Params: productName (string, required), question (string, required).
- **list_leads**: List the most recent lead drafts awaiting review: score (1-10),
  subreddit, title, the drafted reply, and the post URL.
  Params: limit (number, optional, default 10, max 25).
- **keyword_matches**: Recent Reddit posts/comments that hit your tracked
  keywords (the Keyword monitor feed).
  Params: keyword (string, optional filter), limit (number, optional).
- **brand_mentions**: Recent Reddit mentions of your tracked competitors (the
  Brand monitor feed).
  Params: competitor (string, optional filter), limit (number, optional).
- **run_scan**: Run a Reddit scan for the active project now and return how many
  new leads were drafted.
  Params: none.

## Programmatic access (API)

List tools:

    curl -s https://redditoro.com/api/mcp \
      -H "Authorization: Bearer sbk_YOUR_KEY" \
      -H "Content-Type: application/json" \
      -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool:

    curl -s https://redditoro.com/api/mcp \
      -H "Authorization: Bearer sbk_YOUR_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "jsonrpc": "2.0",
        "id": 2,
        "method": "tools/call",
        "params": {
          "name": "check_ai_visibility",
          "arguments": {
            "productName": "Redditoro",
            "question": "best tool to find leads on Reddit"
          }
        }
      }'