threadr-mcp
Provides full access to Reddit including search, browse, read, post, comment, vote, edit, and delete operations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@threadr-mcp show me the top posts from r/golang"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
threadr-mcp
A Model Context Protocol (MCP) server that gives AI agents full access to Reddit search, browse, read, post, comment, vote, edit, and delete. Works with Claude Code, Claude Desktop, VS Code, Cursor, and any MCP-compatible client.
Quick Start
No Reddit API keys required. Anonymous access works out of the box with basic rate limits.
Claude Code
claude mcp add threadr-mcp -- npx -y threadr-mcpClaude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"threadr-mcp": {
"command": "npx",
"args": ["-y", "threadr-mcp"]
}
}
}VS Code / Cursor
Add to your MCP settings:
{
"threadr-mcp": {
"command": "npx",
"args": ["-y", "threadr-mcp"]
}
}Related MCP server: Reddit MCP
Authentication
Threadr supports three tiers of access. Higher tiers unlock more features and higher rate limits.
Tier 1: Anonymous (default)
No configuration needed. All read tools work immediately. Rate limited to ~10 requests/minute.
Tier 2: App-Only
Higher rate limits (~60 req/min), access to NSFW content. Read-only.
Go to reddit.com/prefs/apps
Create a new app (select script type)
Note the client ID (under the app name) and client secret
{
"mcpServers": {
"threadr-mcp": {
"command": "npx",
"args": ["-y", "threadr-mcp"],
"env": {
"REDDIT_CLIENT_ID": "your_client_id",
"REDDIT_CLIENT_SECRET": "your_client_secret"
}
}
}
}Tier 3: User Auth
Full access including write operations (post, comment, vote, edit, delete).
{
"mcpServers": {
"threadr-mcp": {
"command": "npx",
"args": ["-y", "threadr-mcp"],
"env": {
"REDDIT_CLIENT_ID": "your_client_id",
"REDDIT_CLIENT_SECRET": "your_client_secret",
"REDDIT_USERNAME": "your_username",
"REDDIT_PASSWORD": "your_password"
}
}
}
}Environment Variables
Variable | Required | Tier | Description |
| Tier 2+ | 2, 3 | Reddit app client ID |
| Tier 2+ | 2, 3 | Reddit app client secret |
| Tier 3 | 3 | Reddit account username |
| Tier 3 | 3 | Reddit account password |
Tools
Read Tools (all tiers)
Tool | Description | Key Parameters |
| Full-text search across Reddit or within a subreddit |
|
| Subreddit metadata: subscribers, rules, description, flair |
|
| Posts from a subreddit with sort options |
|
| Full post with comment tree, configurable depth |
|
| User profile: karma, account age, badges |
|
| User's submission history |
|
| User's comment history |
|
| Currently popular subreddits |
|
| Single comment with parent chain and replies |
|
| Authenticated user's own profile (Tier 3) | — |
Write Tools (Tier 3 only)
Tool | Description | Key Parameters |
| Create a text or link post |
|
| Add a top-level comment to a post |
|
| Reply to a comment |
|
| Upvote, downvote, or unvote |
|
| Edit your own post |
|
| Edit your own comment |
|
| Delete your own post |
|
| Delete your own comment |
|
Pagination
Listing tools support cursor-based pagination. Responses include next_cursor when more results are available. Pass it as the after parameter to get the next page.
Rate Limiting
Threadr includes a built-in rate limiter that respects Reddit's API limits:
Tier 1 (anonymous): 10 requests/minute
Tier 2/3 (authenticated): 60 requests/minute
Requests are queued when the limit is reached, not rejected.
Development
git clone https://github.com/msaeedsakib/threadr-mcp.git
cd threadr-mcp
bun install
bun run build
bun testLicense
MIT
Available Tools
18 toolscreate_postA
Create a text or link post in a subreddit (requires user auth)
Inputs: title (required), content (required), subreddit (required), nsfw, +3 more.
delete_commentB
Delete your own comment (requires user auth)
Inputs: comment_id (required).
delete_postA
Delete your own post (requires user auth)
Inputs: post_id (required).
edit_commentB
Edit your own comment (requires user auth)
Inputs: content (required), comment_id (required).
edit_postB
Edit your own post (requires user auth)
Inputs: content (required), post_id (required).
get_comment_threadC
Get a single comment with parent chain and replies
Inputs: comment_id (required), depth, context.
get_my_profileA
Get the authenticated user's own profile (requires user auth)
Inputs: no named parameters.
get_post_detailC
Get full post with comment tree, configurable depth and sorting
Inputs: post_id (required), comment_sort, comment_depth, comment_limit.
get_subreddit_infoC
Get subreddit metadata: subscribers, rules, description, flair
Inputs: subreddit (required).
get_subreddit_postsC
Get posts from a subreddit with sort options (hot, new, top, rising, controversial)
Inputs: subreddit (required), sort, after, limit, +1 more.
get_trending_subredditsC
Get currently popular subreddits
Inputs: limit.
get_user_commentsC
Get a user's comment history
Inputs: username (required), sort, after, limit, +1 more.
get_user_postsC
Get a user's submission history
Inputs: username (required), sort, after, limit, +1 more.
get_user_profileB
Get a Reddit user's public profile: karma, account age, badges
Inputs: username (required).
reply_to_commentC
Reply to a comment (requires user auth)
Inputs: content (required), comment_id (required).
reply_to_postC
Add a top-level comment to a post (requires user auth)
Inputs: content (required), post_id (required).
search_postsC
Full-text search across Reddit or within a specific subreddit
Inputs: query (required), sort, after, limit, +2 more.
voteC
Upvote, downvote, or unvote on a post or comment (requires user auth)
Inputs: direction (required), target_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Most tools target distinct resource+action pairs (search vs. subreddit listing vs. post detail vs. comment thread), and the read/write split is clear. Some boundary overlap exists between search_posts and get_subreddit_posts, and between get_post_detail and get_comment_thread, but descriptions adequately differentiate them.
Nearly all tools follow a predictable verb_noun or verb_to_noun pattern (get_subreddit_info, create_post, reply_to_comment, delete_comment). The lone bare verb 'vote' is a minor deviation but doesn't break readability.
18 tools is slightly on the heavy side but well justified by the mix of read operations, user-scoped queries, and authenticated write actions. Each tool maps to a distinct Reddit capability rather than padding the surface.
Core lifecycle is well covered: search, discovery, post/comment read and full CRUD, replies, voting, and self-profile. Gaps remain for common Reddit actions like save/unsave, subscribe, inbox/messages, and moderation, but the agent can accomplish most core workflows.
Related MCP Connectors
MCP server for building and testing AI agents with multi-model experimentation and insights.
Web search API and MCP server for developers building AI agents.
Reddit & X data for AI agents over MCP. Semantic search, hosted, no Reddit API.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA specialized MCP server that enables AI agents to interact with Reddit, including reading posts, creating content, and managing subreddit configurations.136 npm10Apache 2.0
- AlicenseBqualityDmaintenanceA plug-and-play MCP server that enables AI assistants to browse, search, and read Reddit content through the PRAW library.619MIT
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to access and interact with Reddit content through features like user analysis, post retrieval, subreddit statistics, and authenticated posting capabilities.15301MIT
- AlicenseAqualityCmaintenanceAn MCP server that enables authenticated Reddit account actions like posting, commenting, voting, and messaging via the Reddit API.1232 npmMIT