RedScraper Logo
RedScraper Logo
Sign inSign up

Reddit MCP Server

Give Claude, Cursor, VS Code and other AI agents live Reddit data. RedScraper's remote MCP server offers 19 tools to scrape posts, comments, subreddits and user profiles and read the results, with the same API keys as the Reddit Scraper API.

Get an API keySetup instructionsREST API docs

What is an MCP server?

The Model Context Protocol (MCP) is an open standard that lets AI assistants use tools from other services. You add a server to your MCP client once; from then on the agent decides when to call its tools to answer your requests.

With the RedScraper MCP server, an agent can:

  • Search Reddit by keyword or scrape a subreddit, post, comment thread or user profile URL
  • Collect posts, comments, subreddits and user profiles with only the fields the task needs
  • Wait for a scrape to finish and read the results in small pages it can reason over
  • Check your remaining compute hours, past scrapes and subscription

It is a hosted, remote server: there is nothing to install or run, and the scraping happens on RedScraper's side. Prefer writing code? The same features are available through the Reddit Scraper API.


Server details

AI assistants and agents such as Claude, Cursor and VS Code can use RedScraper through its remote MCP (Model Context Protocol) server. It offers the same features as the REST API as tools, and uses the same API keys.
ItemValue

Server URL

https://api.redscraper.io/mcp

Transport

Streamable HTTP (POST only). Stateless: plain JSON responses, no SSE stream or session.

Authentication

Your API key on every request: Authorization: Bearer YOUR_API_KEY (or X-API-Key). There is no OAuth sign-in step.

Protocol versions

2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05

Rate limit

1,000 requests per hour per API key, shared with the REST API. Every tool call counts, also inside a JSON-RPC batch.

Connect your client

Create an API key in the dashboard under API management, then replace YOUR_API_KEY in the snippet for your client.

Claude Code

Run once in your terminal:

claude mcp add --transport http redscraper https://api.redscraper.io/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor

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

{
  "mcpServers": {
    "redscraper": {
      "url": "https://api.redscraper.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "redscraper": {
      "type": "http",
      "url": "https://api.redscraper.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

Clients that only support local (stdio) servers can connect through mcp-remote (requires Node.js 18+). Add to claude_desktop_config.json and restart the app. The header value lives in env, not args, because some clients (Claude Desktop on Windows, Cursor) split args at spaces:

{
  "mcpServers": {
    "redscraper": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.redscraper.io/mcp",
        "--header",
        "Authorization:${REDSCRAPER_AUTH_HEADER}"
      ],
      "env": {
        "REDSCRAPER_AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Test with cURL

Every request is a stateless JSON-RPC 2.0 POST. List the tools your key can use:

curl -X POST "https://api.redscraper.io/mcp" \
  -H "Authorization: Bearer $REDSCRAPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

Which access level to use

The server only lists the tools your key's access level allows, so the agent never sees tools it cannot use.
Read-only

Research and reporting agents that only read scrapes, results, usage and billing.

Standard

Agents that start scrapes for you. Recommended for most setups.

Full access

Only if the agent should change your subscription or manage API keys.


Tools

Every tool uses the same rules as the matching REST endpoint. Scrapes started by an agent are marked with source mcp and appear in your dashboard history.

Scrapes

ToolScopeWhat it does

create_scrape

scrapes:write

Start a scrape (same body as POST /v1/scrapes, plus an optional idempotency_key). Uses plan compute hours; refused when they are used up or too many scrapes are running.

get_scrape

scrapes:read

Status of one scrape. wait_seconds (0-25) waits for a running scrape to finish; when the server is busy it answers at once and says when to call again.

get_scrape_results

scrapes:read

Rows of a completed scrape: offset, limit (default 50, max 200), type filter and fields projection.

list_scrapes

scrapes:read

Scrapes from the dashboard, API and MCP, newest first, filterable by status and source.

cancel_scrape

scrapes:write

Abort a running scrape.

list_data_fields

any key

Field keys per data type and the allowed sort and time values.

Account & usage

ToolScopeWhat it does

get_account

account:read

Profile, subscription summary and the API key in use.

update_profile

account:write

Change your first and/or last name.

get_usage

scrapes:read

Run statistics plus compute hours used and remaining in the current billing period.

contact_support

account:write

Send a message to RedScraper support from your account.

Billing

ToolScopeWhat it does

list_plans

any key

Plans with monthly price and included compute hours.

get_subscription

billing:read

Current plan, status, renewal date and any scheduled plan change.

list_transactions

billing:read

Payment history, newest first.

start_subscription_checkout

billing:write

Returns a Stripe Checkout link for you to open and pay in a browser. Nothing is charged by the call.

change_plan

billing:write

Previews the change unless confirm is true. Confirmed upgrades charge the card immediately; downgrades apply next period.

cancel_subscription

billing:write

Previews unless confirm is true. Cancels at the end of the billing period.

API keys

ToolScopeWhat it does

list_api_keys

keys:read

Your API keys with access level and last use (never their secrets).

create_api_key

keys:write

Create a key (returned once). It cannot have more access than the key in use.

revoke_api_key

keys:write

Revoke one of your API keys.


How agents use it

  1. create_scrape starts the scrape and returns its id with status "running".
  2. get_scrape with that id and wait_seconds: 25, repeated while the status is "running" (if the result has a nextStep, follow it).
  3. get_scrape_results once the status is "completed" (use fields to keep responses small).

When a tool call cannot be completed (invalid arguments, no subscription, a scrape that has not finished) the tool returns an error message the agent can read and act on. Try a prompt like:

Use RedScraper to collect the top 100 posts about "AI agents" from the past week, then summarize the main themes with links to the most upvoted posts.

Example prompts

Once the server is connected, ask for Reddit data in plain language. The agent picks the tools, starts the scrape and works with the results.
Use RedScraper to collect the top 100 posts about "AI agents" from the past week, then summarize the main themes with links to the most upvoted posts.
Scrape the 200 newest posts from https://www.reddit.com/r/startups/new and list the 10 questions founders ask most often.
Find Reddit posts from the past month that mention "CRM for freelancers" and draft a short report on the tools people recommend.
How many compute hours do I have left this month, and what were my last 5 scrapes?

Safety and control

  • The server only lists the tools your key's access level allows. A Read-only key cannot start scrapes or change anything, and only Full access keys can touch billing or API keys.
  • Billing changes are never made by accident: change_plan and cancel_subscription preview the change until the agent calls them again with confirm: true, and checkout only returns a link for you to pay.
  • Every scrape an agent starts is marked with source mcp and appears in your dashboard history, so you can see what it did.
  • Use a separate key for each agent or client and revoke it in the dashboard at any time. These actions stay in the dashboard and are never available to agents: Sign in, registration and Google sign-in; Changing or resetting your password; Deleting your account; Signing out of all sessions.

rocket

Connect your AI agent to Reddit

Create an API key, paste the snippet for your client and ask your first question.