Model Context Protocol Ready

The Reddit MCP Server for AI Agents

Give Claude, Cursor, Windsurf, and custom autonomous agents native tools to search Reddit, extract full comment trees, and analyze discussions in real time.

Get Your Free API Key Read MCP Setup Guide

14 Native MCP Tools Zero Reddit App Approval Works in Cursor & Claude

Add Reddit to your AI agent in 30 seconds

Paste this into your Claude Desktop, Cursor, or Windsurf config file.

claude_desktop_config.json / cursor mcp.json

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "@subscraper/mcp"],
      "env": {
        "SUBSCRAPER_API_KEY": "sk-your-subscraper-api-key"
      }
    }
  }
}

REST API vs. MCP Server

Choose the integration model that best suits your application architecture.

Capability	SubScraper MCP Server	Standard REST API
Best For	Autonomous AI agents, Cursor, Claude Desktop	Backend services, web apps, ETL data pipelines
Integration Code	Zero code (JSON configuration block)	SDK or HTTP fetch calls
Tool Invocation	LLM decides when & how to call Reddit tools	Deterministic execution by application code
Endpoints Exposed	All 14 endpoints as agent functions	All 14 endpoints

All 14 Exposed MCP Tools

Every tool includes complete parameter schemas and descriptions for high LLM accuracy.

reddit_search

Search posts across all of Reddit or in a specific subreddit with sorting and time filters.

reddit_get_post

Retrieve full post content, body text, and complete paginated comment trees.

reddit_get_community_posts

Fetch hot, new, top, rising, or controversial posts from any public subreddit.

reddit_get_community_details

Get subreddit metadata including rules, subscriber counts, and description.

reddit_get_user_profile

Fetch karma breakdown, account age, bio description, and public profile metrics.

reddit_get_user_posts

Get all historical public submissions made by a specific Reddit user.

reddit_get_user_comments

Retrieve public comment history for a specific Reddit user.

reddit_search_communities

Find subreddits relevant to specific keywords or topic areas.

reddit_search_users

Search and discover Reddit users by username prefix or keyword.

reddit_get_comment_permalink

Retrieve a specific comment alongside parent context and direct replies.

reddit_get_popular

Get current trending submissions across r/popular.

reddit_get_leaderboard

Inspect trending communities leaderboard by category and growth.

reddit_resolve_url_type

Parse and classify any Reddit URL into post, comment, community, or user.

reddit_explore

Explore communities categorized by topical verticals and interests.

See it in action: Cursor & Claude Desktop

Prompt your agent naturally and let it execute multi-step Reddit research autonomously.

User Prompt to Agent

“Search Reddit for recent complaints about Vercel pricing in r/webdev and summarize the top three concerns.”

Autonomous Agent Actions

→ Called tool reddit_search(query="Vercel pricing", subreddit="webdev", sort="top", time="month")
→ Inspected top 3 post threads with reddit_get_post(postId="...")
✓ Delivered clear synthesized analysis with direct permalinks back to the Reddit discussions.

Frequently Asked Questions

What is the SubScraper Reddit MCP Server?

The SubScraper Reddit MCP server is an integration exposing our 14 Reddit API endpoints as native tools for AI assistants like Claude Desktop, Cursor, and Windsurf.

Which AI clients support this Reddit MCP server?

Any client supporting the Model Context Protocol specification, including Cursor IDE, Claude Desktop, Windsurf, Cline (VS Code), and custom LangChain/LlamaIndex agents.

Do I need a Reddit developer account to use the MCP server?

No. SubScraper handles residential proxy rotation, Reddit anti-bot mitigations, and data structuring. You only need a SubScraper API key.

How do I install the MCP server?

Add a standard mcpServers configuration block to your client config file using npx @subscraper/mcp with your API key.

Equip your AI agent with live Reddit data.

Get your API key in seconds and connect the Reddit MCP server today.

Start Free