MCP server · 6 tools · 8 endpoints

Reddit MCP server

Comment threads, subreddit listings, user histories and keyword search from public Reddit, read by your agent at 2 credits a row.

Get a free key Connect in a minute

100 credits on signup · No card · Sign in with OAuth or paste a key

scrapersocial-reddit mcp.scrapersocial.com/redditconnected

you

Read the comments on <reddit-post-url> and tell me what the thread concluded.

agent

calls get_comments 2 credits / comment

{ "url": "<Reddit comment url>" }

server

returns

comments [{ … }] · one per comment cursor string | null · next page

Shape only. Keys follow the tool's summary; a real call returns the full record. 1 call · 2 credits

Connect

One URL. Your client already knows what to do with it.

The first call opens a sign-in. New accounts get 100 credits, no card. Every client below shares one account and one balance.

Get a free key

server url https://mcp.scrapersocial.com/reddit

claude.aiOAuth

Settings → Connectors → Add custom connector, then paste the server URL.

mcp.scrapersocial.com/reddit

Web, desktop and mobile. Nothing else to paste.

Claude Codeone command

Run this in a terminal.

$ claude mcp add --transport http scrapersocial-reddit https://mcp.scrapersocial.com/reddit

Approve the sign-in prompt on first use.

Cursorone click

Installs the server and opens the MCP panel.

Add to Cursor

or paste the JSON into .cursor/mcp.json

{
  "mcpServers": {
    "scrapersocial-reddit": {
      "url": "https://mcp.scrapersocial.com/reddit",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Other clients · VS Code, Windsurf, Gemini CLI, anything that speaks MCP

VS Codeone click or JSON

Add to VS Codeor run MCP: Add Server, choose HTTP and use:

{
  "name": "scrapersocial-reddit",
  "type": "http",
  "url": "https://mcp.scrapersocial.com/reddit"
}

Windsurf~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "scrapersocial-reddit": {
      "serverUrl": "https://mcp.scrapersocial.com/reddit",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Gemini CLI~/.gemini/settings.json

{
  "mcpServers": {
    "scrapersocial-reddit": {
      "httpUrl": "https://mcp.scrapersocial.com/reddit",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Any clientStreamable HTTP · OAuth 2.1 or Bearer

$ npx add-mcp https://mcp.scrapersocial.com/reddit

One account and one balance across every client and the every-platform hub at mcp.scrapersocial.com.

What it does

What your agent can do with Reddit

Reddit is where people say what they actually think, and most of the value sits in the comments rather than the post. This server gives an agent four direct tools and eight endpoints to work with. get_comments is handed a post URL and returns the thread at 2 credits per comment, newest first, paging with a cursor. search sweeps public posts for a keyword at 2 per result. get_profile returns a user’s public record for 4 and get_channel_posts their posting history at 2 per post.

The subreddit side lives behind call_endpoint. The subreddit endpoint lists a community’s current posts for 2 per post, subreddit-details returns its description and subscriber count for 4, subreddit-search finds communities for a topic at 2 per result, and post returns a single submission for 4. list_endpoints prints all of that with inputs and prices and is free to call.

Where this fits: product research, brand monitoring, finding the right communities before you post, and summarising what a long thread concluded. Reddit threads run long, so set your limit deliberately. Fifty comments is one call and 100 credits, which is also exactly the balance you get free on signup, so a first experiment might be a 20-comment page for 40.

Five jobs it finishes on its own

Summarise a long thread

Paste a post URL, the agent pulls the comments and writes the consensus, the dissent and the best-rated answer. Good for research threads where the top comment is better than the post.

Hear how a product is really discussed

search for the product name, pull the top results, then get_comments on the ones with the most discussion. Complaints on Reddit are specific in a way reviews elsewhere aren't.

Monitor a subreddit for mentions

The subreddit endpoint via call_endpoint lists current posts for 2 credits each. An agent on a schedule can flag new posts matching your keywords and link them to you.

Check a user's history before engaging

get_profile and get_channel_posts show what an account posts and where. Useful for moderators, for spotting astroturfing, and for deciding whether a reply is worth writing.

Find the communities for a topic

subreddit-search returns matching communities, subreddit-details adds subscriber counts and descriptions. Shortlist the places that matter before you post or advertise.

Limits · read before you connect

What this does not do

Written by a person, not generated. If something here is wrong, tell us.

The server reads what Reddit shows without a login: public posts, public comments, public profiles and public subreddits. Private and quarantined communities, removed comments and suspended accounts aren’t reachable, and a not-found reply is free. There’s no transcript, summary or download capability on this spoke; Reddit video isn’t covered. Each list call returns up to 50 rows at 2 credits apiece, with a floor of 1 credit per successful call. Comments arrive newest first rather than in Reddit’s own ranking, so re-sort them if ranking matters to you. Read-only: no voting, posting or messaging.

Tools

6 tools, same names as the every-platform hub

Four do one Reddit thing each. The last two reach all 8 endpoints by path, so nothing in the catalog is out of an agent's reach.

Full credit table →

Read comments on a post

get_comments

Comments on a public post or video, newest first, paginated with limit and cursor.

2 credits / comment

Get an account profile

get_profile

Profile, page or channel record for a public account: follower and subscriber counts, bio, and totals.

4 credits / profile

List an account's posts

get_channel_posts

Recent public posts or videos from one account, with per-item metrics.

2 credits / post

Search a platform

search

Keyword search over one platform's public content.

2 credits / result

Reaches the other 4 endpoints

List every Reddit endpoint

list_endpoints

Browse every Reddit endpoint, its input and its credit cost. Free, and calls nothing upstream.

free

Call any Reddit endpoint by path

call_endpoint

Run any Reddit endpoint by its path, so nothing Reddit offers is out of reach of an agent.

endpoint's own cost

Pricing

100 free credits is 50 comments, or 25 profile reads.

Then $5 a month for 1,000 credits, or $4 per 1,000 as a top-up. No card to start. Calls cost between 2 and 4 credits on Reddit.

50 commentsget_comments · 2 each

25 profile readsget_profile · 4 each

Get a free key 100 credits on signup · $5 for 1,000 · full credit table

Prompts

Things to ask once it is connected

Copy one, swap the placeholder, paste it into your client.

Read the comments on <reddit-post-url> and tell me what the thread concluded.

Search Reddit for "<product name>" and list the ten posts with the most discussion.

What has <u/username> posted in the last month, and in which subreddits?

List the newest 25 posts in r/<subreddit> with their scores.

Find subreddits about <topic> and rank them by subscriber count.

Pull <reddit-post-url> and the first 50 comments, then draft a reply that answers the most common question.

Questions

Before you connect

Do I need a Reddit account or API key? #

No. The server uses your ScraperSocial key only. No Reddit login is created or used, which is also why private communities are out of reach.

Why did a comments call cost 40 credits? #

Comments are 2 credits each and you asked for 20, the default page size. Set limit lower if you only want a sample, or up to 50 for the biggest page.

Is this Reddit's official API? #

No, and it doesn't pretend to be. ScraperSocial is an independent company with no ties to Reddit, Inc. Reddit's own API remains the route for writes and for anything requiring OAuth.

Can it read private or quarantined subreddits? #

No. Only communities a logged-out visitor can open. Anything else answers not found, unbilled.

Where are the subreddit tools? #

They're endpoints rather than named tools: /v1/reddit/subreddit, /v1/reddit/subreddit-details and /v1/reddit/subreddit-search. Call them through call_endpoint; list_endpoints shows their inputs.

Does it return the full comment tree? #

It returns the comments for a post, paginated 50 at a time. For a thread with hundreds of comments, page through with the cursor until next_cursor is empty.

Go further

Reddit answers questions nobody asked on your survey. Give Claude or Cursor this server and a thread URL, and you get the answer in a paragraph for a few credits. The first 100 are free, no card, and 1,000 a month runs $5.

Get a free key 100 credits, no card

ScraperSocial is independent and not affiliated with, endorsed by or connected to Reddit. Publicly available data only.