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.
What is an MCP server?
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
| Item | Value |
|---|---|
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
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
Research and reporting agents that only read scrapes, results, usage and billing.
Agents that start scrapes for you. Recommended for most setups.
Only if the agent should change your subscription or manage API keys.
Tools
Scrapes
| Tool | Scope | What 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
| Tool | Scope | What 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
| Tool | Scope | What 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
| Tool | Scope | What 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
- create_scrape starts the scrape and returns its id with status "running".
- get_scrape with that id and wait_seconds: 25, repeated while the status is "running" (if the result has a nextStep, follow it).
- 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
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_planandcancel_subscriptionpreview the change until the agent calls them again withconfirm: true, and checkout only returns a link for you to pay. - Every scrape an agent starts is marked with source
mcpand 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.

Connect your AI agent to Reddit
Create an API key, paste the snippet for your client and ask your first question.