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.0015 per call (or a monthly read plan from $19 for 30,000 reads), every account gets 1,000 free reads a month, and new accounts get $0.50 of free credit with no card. Connect your Reddit account once to comment, post, vote and DM as you. 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](https://www.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):

{

"mcpServers": { "reddit": { "command": "npx", "args": ["-y", "redditapis-mcp@latest"], "env": { "REDDITAPIS_KEY": "YOUR_API_KEY" } } } }

Restart Claude Desktop. The reddit_* tools appear in the tool picker.

Claude Code

claude mcp add reddit --env REDDITAPIS_KEY=YOUR_API_KEY -- npx -y redditapis-mcp@latest

Cursor

~/.cursor/mcp.json (or Settings > MCP > Add New Server):

{

"mcpServers": { "reddit": { "command": "npx", "args": ["-y", "redditapis-mcp@latest"], "env": { "REDDITAPIS_KEY": "YOUR_API_KEY" } } } }

Windsurf

~/.codeium/windsurf/mcp_config.json:

{

"mcpServers": { "reddit": { "command": "npx", "args": ["-y", "redditapis-mcp@latest"], "env": { "REDDITAPIS_KEY": "YOUR_API_KEY" } } } }

VS Code (Copilot / agent mode)

.vscode/mcp.json in your workspace, or the user-level MCP settings:

{

"servers": { "reddit": { "type": "stdio", "command": "npx", "args": ["-y", "redditapis-mcp@latest"], "env": { "REDDITAPIS_KEY": "YOUR_API_KEY" } } } }

Configuration

Authentication is a Bearer token: the server sends Authorization: Bearer on every request.

Tools

60 tools and 3 playbook resources: 33 Reddit reads, 10 Reddit account tools (connect, status, disconnect, comment, submit, vote, DM, and schedule, list or cancel a post or comment for later), 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 (commenting, posting, voting, DMs) act as YOUR Reddit account and only after you connect it with reddit_connect; each is marked as a write so your client asks before it runs. 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

Subreddits

Posts and comments

Users

Community browse (no keyword)

Monitoring: manage your own monitors and webhooks

Monitors watch named subreddits or all of Reddit, for posts or comments (kind). Every account holds a free entitlement of one all-of-Reddit post watch at a 60s cadence; naming a su