1. Conduid
  2. Social
  3. Threadr
MCP server · Social

Threadr

· github.com/msaeedsakib/threadr-mcp

A Model Context Protocol server that gives AI agents full access to Reddit

Unclaimed mcpredditmodel-context-protocolaiclaude
InstallView source
37Low

Scored 6 months ago · breakdown

About Threadr

Threadr is an MCP server in the Social category: a Model Context Protocol server that gives AI agents full access to Reddit.

Install

Claude Code
claude mcp add threadr -- npx -y threadr-mcp
npx
npx -y threadr-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (10)

get_comment_threadSingle comment with parent chain and replies

Parameters not published.

get_my_profileAuthenticated user's own profile (Tier 3)

Parameters not published.

get_post_detailFull post with comment tree, configurable depth

Parameters not published.

get_subreddit_infoSubreddit metadata: subscribers, rules, description, flair

Parameters not published.

get_subreddit_postsPosts from a subreddit with sort options

Parameters not published.

get_trending_subredditsCurrently popular subreddits

Parameters not published.

get_user_commentsUser's comment history

Parameters not published.

get_user_postsUser's submission history

Parameters not published.

get_user_profileUser profile: karma, account age, badges

Parameters not published.

search_postsFull-text search across Reddit or within a subreddit

Parameters not published.

Ask AI

✦

Ask AI about Threadr

Powered by Claude · Grounded in docs

I know everything about Threadr. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

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-mcp

Claude 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"]
  }
}

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.

  1. Go to reddit.com/prefs/apps
  2. Create a new app (select script type)
  3. 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
REDDIT_CLIENT_ID Tier 2+ 2, 3 Reddit app client ID
REDDIT_CLIENT_SECRET Tier 2+ 2, 3 Reddit app client secret
REDDIT_USERNAME Tier 3 3 Reddit account username
REDDIT_PASSWORD Tier 3 3 Reddit account password

Tools

Read Tools (all tiers)

Tool Description Key Parameters
search_posts Full-text search across Reddit or within a subreddit query, subreddit?, sort, time_filter, limit, after
get_subreddit_info Subreddit metadata: subscribers, rules, description, flair subreddit
get_subreddit_posts Posts from a subreddit with sort options subreddit, sort (hot/new/top/rising/controversial), limit, after
get_post_detail Full post with comment tree, configurable depth post_id, comment_limit, comment_depth, comment_sort
get_user_profile User profile: karma, account age, badges username
get_user_posts User's submission history username, sort, time_filter, limit, after
get_user_comments User's comment history username, sort, time_filter, limit, after
get_trending_subreddits Currently popular subreddits limit
get_comment_thread Single comment with parent chain and replies comment_id, depth, context
get_my_profile Authenticated user's own profile (Tier 3) —

Write Tools (Tier 3 only)

Tool Description Key Parameters
create_post Create a text or link post subreddit, title, content, is_self?, flair_id?, nsfw?, spoiler?
reply_to_post Add a top-level comment to a post post_id, content
reply_to_comment Reply to a comment comment_id, content
vote Upvote, downvote, or unvote target_id, direction (up/down/unvote)
edit_post Edit your own post post_id, content
edit_comment Edit your own comment comment_id, content
delete_post Delete your own post post_id
delete_comment Delete your own comment comment_id

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 test

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Threadr

How do I install Threadr?

Run claude mcp add threadr -- npx -y threadr-mcp, then add the server to your MCP client's configuration.

Is Threadr safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Threadr still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.