redditapis/redditapis-mcp

redditapis-mcp is the official MCP server for RedditAPIs, built for developers and AI agents that need live Reddit data in Claude, Cursor, Windsurf, VS Code or any MCP client, with no Reddit developer app. Your agent can search posts and comments, read subreddit feeds and rules, expand comment trees, look up users and communities, and set up monitors that send new matching posts to your webhook. Reads cost $0.002 per call, and new accounts get $0.50 of free credit with no card. The server only reads Reddit; posting, commenting and voting stay on the RedditAPIs REST API. Every tool maps to one endpoint at api.redditapis.com.
Install: npx -y redditapis-mcp@latest with REDDITAPIS_KEY from https://www.redditapis.com
Hosted, sign in instead of pasting a key (Claude Code): claude mcp add --transport http reddit https://api.redditapis.com/mcp (carries every tool except the 5 that read your own account)
Website: https://www.redditapis.com/mcp
Quick start
No install needed. Run with npx. You need one thing: an API key from **redditapis.com**. Reads work with just that key, so there is no account login or session step to set up. Monitor/webhook management additionally requires an active monitoring plan (monitoring has no free tier).
Setup
Claude Desktop
Edit claude_desktop_config.json (Settings > Developer > Edit Config):
Restart Claude Desktop. The reddit_* tools appear in the tool picker.
Claude Code
Cursor
~/.cursor/mcp.json (or Settings > MCP > Add New Server):
Windsurf
~/.codeium/windsurf/mcp_config.json:
VS Code (Copilot / agent mode)
.vscode/mcp.json in your workspace, or the user-level MCP settings:
Configuration
| Env var | Required | Default | Purpose |
|---|---|---|---|
| REDDITAPIS_KEY | Yes | (none) | API key from redditapis.com. REDDIT_APIS_KEY is accepted as an alias. |
| REDDITAPIS_BASE_URL | No | https://api.redditapis.com | Override the API host. |
| REDDITAPIS_TIMEOUT_MS | No | 30000 | Per-request timeout in milliseconds. |
| REDDITAPIS_FEEDBACK_DIR | No | ~/.redditapis | Where reddit_feedback_send keeps its local draft queue (feedback-queue.json). |
Authentication is a Bearer token: the server sends Authorization: Bearer on every request.
Tools
47 tools and 3 playbook resources: 30 Reddit reads, 10 monitor/webhook management tools, reddit_set_watch (one call that stands up a whole watch), reddit_explain (where the rows you are holding came from), 3 feedback tools, and 2 account tools (reddit_account_me, which is also where the credit balance lives, and reddit_account_payments, the top-up history). Reddit writes (posting, commenting, voting, DMs) remain a separate authenticated surface and are intentionally out of scope here -- monitor/webhook tools configure your OWN redditapis.com account (an alerting subscription), never Reddit itself, and the feedback tools send a report to the redditapis.com team, never to Reddit. Every read works with just your API key; the 6 monitor/webhook writes additionally need an active monitoring plan (see Monitoring below). The feedback tools are free and need only your key.
A few conventions across the catalog:
- Subreddit names go in **without** the r/ prefix, and usernames **without** the u/ prefix. reddit_subreddit_posts takes its community as subreddit; the /sub/{name}/... tools take it as name.
- Listing and search tools return an after cursor. Pass it back as after to fetch the next page, exactly as it was returned. limit accepts 1 to 100 (the API clamps out-of-range values).
- When after comes back null there is no next page to ask for. That does not always mean you have every item: Reddit often stops serving a busy listing long before it runs out. The final response also carries listing_status, which reads complete, truncated or unknown. Only complete means nothing is missing. Treat the other two as a partial answer and widen across sorts, timeframes or search terms rather than paging deeper.
- t (hour, day, week, month, year, all) sets the time window; on subreddit listings it applies to the top and controversial sorts, and on search it bounds the whole result set.
Search and discovery
| Tool | Endpoint | What it does |
|---|---|---|
| reddit_search | GET /api/reddit/search | Search posts across all of Reddit or within one subreddit (subreddit). |
| reddit_search_comments | GET /api/reddit/search/comments | Search by comment text; returns the parent posts, since Reddit's comment search does not hand back the matching comment itself. |