Reddit MCP

Reddit data as a REST API and MCP server. API and MCP requests require an Authorization: Bearer token header.

Live Vercel · Bun MCP Compatible v1.0.0

REST API

GET /api/search?q={query} Try it → Search Reddit for posts, comments, subreddits, or users

GET /api/r/{subreddit} Try it → Get subreddit info — subscribers, description, rules

GET /api/r/{subreddit}/posts Try it → Get posts from a subreddit with sort & time filters

GET /api/post/{id} Get a post by ID, optionally with comments

GET /api/user/{username} Try it → Get a user profile — karma, account age, etc.

GET /api/user/{username}/activity Get a user's recent posts and comments

POST /api/feed Combined feed from multiple subreddits, merged by date

Quick Start

# Search Reddit
curl "https://reddit-mcp.bysrijan.com/api/search?q=rust+programming&limit=5" -H "Authorization: Bearer YOUR_API_AUTH_TOKEN"

# Get top posts from r/webdev
curl "https://reddit-mcp.bysrijan.com/api/r/webdev/posts?sort=top&time=week&limit=10" -H "Authorization: Bearer YOUR_API_AUTH_TOKEN"

# Multi-subreddit feed
curl -X POST "https://reddit-mcp.bysrijan.com/api/feed" -H "Authorization: Bearer YOUR_API_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"subreddits":["typescript","rust","golang"],"limit":15}'

MCP Server

This server speaks the Model Context Protocol over Streamable HTTP. Connect any MCP client. Set its Authorization header to Bearer followed by your API_AUTH_TOKEN.

https://reddit-mcp.bysrijan.com/mcp

Available tools:

search_reddit

get_post

get_subreddit

get_subreddit_posts

get_user

get_user_activity

get_multi_feed

Install

Claude Desktop

Claude Desktop only supports stdio servers natively, so bridge through mcp-remote. Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["mcp-remote", "https://reddit-mcp.bysrijan.com/mcp", "--header", "Authorization: Bearer YOUR_API_AUTH_TOKEN"]
    }
  }
}

Claude Code (CLI)

Run this in your terminal:

claude mcp add reddit --transport http https://reddit-mcp.bysrijan.com/mcp --header "Authorization: Bearer YOUR_API_AUTH_TOKEN"

Cursor

Add to .cursor/mcp.json in your project root:

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

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

Cline (VS Code)

Open Cline settings → MCP Servers → add:

{
  "mcpServers": {
    "reddit": {
      "type": "streamableHttp",
      "url": "https://reddit-mcp.bysrijan.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_AUTH_TOKEN" }
    }
  }
}

Local (stdio via npx)

Run the MCP server locally with Bun:

# Clone and run
git clone https://github.com/Srijan-t0d0/reddit-mcp.git
cd reddit-mcp && bun install
bun run start

Then add to your MCP client config:

{
  "mcpServers": {
    "reddit": {
      "command": "bun",
      "args": ["run", "start"],
      "cwd": "/path/to/reddit-mcp"
    }
  }
}

Tool Reference

search_reddit

Search Reddit for posts, comments, subreddits, or users.

query (required), type, sort, time, subreddit, limit, after

get_post

Get a Reddit post by ID, optionally with comments.

postId (required), includeComments, commentSort, commentLimit, commentDepth

get_subreddit

Get information about a subreddit.

name (required)

get_subreddit_posts

Get posts from a subreddit with sort and time filters.

subreddit (required), sort, time, limit, after

get_user

Get a Reddit user profile.

username (required)

get_user_activity

Get a user's recent posts and comments.

username (required), type, sort, time, limit, after

get_multi_feed

Combined feed from multiple subreddits, merged and sorted.

subreddits (required), sort, time, limit, perSubreddit