Skip to main content
Glama
threadr-mcp

threadr-mcp

by msaeedsakib

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.

License: MIT

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

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.

  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

Available Tools

18 tools
create_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_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

    B3.1/5.0

    Scored across 18 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      15
      301
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that enables authenticated Reddit account actions like posting, commenting, voting, and messaging via the Reddit API.
      12
      32 npm
      MIT