MCP & API access

Drive Redditoro from Claude, Cursor, or any MCP client — find subreddits, check rules, generate a content plan, and check your AI-search visibility, all from a prompt. The same endpoint doubles as a JSON-RPC API you can call directly.

What is this?

Redditoro exposes an MCP (Model Context Protocol) server. MCP is an open standard that lets AI apps like Claude and Cursor call external tools. Point your client at our endpoint, and your assistant can operate your Redditoro account for you — no code required.

Prefer to script it yourself? The same endpoint speaks plain JSON-RPC 2.0 over HTTP, so you can call it with curl or any HTTP library. See Programmatic access below.

Endpoint

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 your MCP / API access page in the dashboard. 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.

Connect Claude Desktop

Claude Desktop connects to remote servers through the mcp-remote bridge. Open Settings → Developer → Edit Config and add Redditoro to mcpServers, then restart the app:

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

Connect Cursor

Cursor supports remote MCP servers with headers natively. Add this 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"
      }
    }
  }
}

Any other MCP-capable client works too — give it the endpoint above and the Authorization header.

Tools

find_subreddits

Find the best subreddits to reach a product's target customers, ranked by fit with a short reason for each.

Params: description (string, optional) — what the product does and who it's for. 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 to mention a product.

Params: subreddit (string, required) — e.g. SaaS.

generate_content_plan

Generate a 7-day Reddit content plan (a mix of 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 — a proxy for whether ChatGPT and Claude recommend it.

Params: productName (string, required), question (string, required) — e.g. best tool to find leads on Reddit.

Programmatic access (API)

There's no separate REST API and no CLI to install — the MCP endpoint is the API. List the 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 one:

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

Responses follow JSON-RPC 2.0: results come back under result.content as text blocks. The same requests work from any language — just POST JSON with your Bearer key.

Need a key?

Head to MCP / API access in your dashboard to create one. Questions? Email [email protected].