Skip to main content
Glama
CiteRocket MCP

CiteRocket MCP

Official

Reddit MCP: the Reddit API for Claude, Cursor and any MCP client

npm License: MIT

The official CiteRocket MCP server, the fastest way to use the Reddit API from an AI assistant. Give Claude, Cursor, or any Model Context Protocol client direct access to Reddit data: search Reddit posts and comments, pull a subreddit's top, read full comment trees, look up users and their karma, search communities, media and users, and run shadowban checks, all over one clean, fast, camelCase JSON API.

Tools stay current automatically. When CiteRocket ships a new endpoint, the new tool shows up on your next restart, with no reinstall and no config change.

→ Get an API key at citerocket.com · API docs · Rate limits


Install

Add it to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "citerocket": {
      "command": "npx",
      "args": ["-y", "@citerocket/reddit-mcp@latest"],
      "env": {
        "CITEROCKET_API_KEY": "cite_live_..."
      }
    }
  }
}

Get your CITEROCKET_API_KEY from the CiteRocket dashboard. That's all it needs.

Or via the Claude Code CLI:

claude mcp add citerocket -e CITEROCKET_API_KEY=cite_live_... -- npx -y @citerocket/reddit-mcp@latest

Related MCP server: MCP Reddit Server

What you can do

Once installed, just ask your assistant naturally:

"Find the top posts in r/programming this week" "Search Reddit for posts about the new iPhone, sorted by top" "What's u/spez's karma and account age?" "Is u/some_account shadowbanned or suspended?" "Get the full comment tree for this post: https://reddit.com/r/..." "Search r/startups comments that mention 'pricing'" "Show me the rules and moderators of r/webdev"


Tools

All tools are read-only. Query parameters are snake_case; responses are camelCase JSON.

Tool

What it does

get_posts

Fetch posts from a subreddit

get_search

Search posts across Reddit

get_comments

A post's full comment tree

get_post_by_id

Fetch one post by id

get_sub_by_name_top

A subreddit's top posts

get_sub_by_name_info

Subreddit metadata, rules, moderators

get_user_by_name

User profile and karma

get_user_by_name_comments

A user's recent comments

get_user_by_name_status

Account status / shadowban check

get_search_communities

Search communities

get_search_comments

Search comments

get_search_media

Search media

get_search_users

Search users

get_cite_rocket_overview

Your credit, usage, and billing snapshot

The live set is whatever the server pulls from the manifest at startup, so this table tracks what's shipped today, not a hardcoded ceiling.


How billing works

Every tool call is a normal CiteRocket API call authenticated with your CITEROCKET_API_KEY, metered exactly like direct API usage, no separate MCP billing. Standard reads cost 1 credit; get_cite_rocket_overview is free. Per-plan QPS ceilings apply, see the rate limits.


Configuration

Env var

Required

Purpose

CITEROCKET_API_KEY

yes

Your API key, sent as Authorization: Bearer on every call.

If CiteRocket is briefly unreachable at startup, the server falls back to the tool set bundled in the package so your existing tools keep working.


Development

npm install
npm run build:manifest   # regenerate the bundled tool manifest from the OpenAPI spec
npm run build            # compile TypeScript to dist/

CiteRocket is an independent third-party API for developers and researchers. Not affiliated with, endorsed by, or sponsored by Reddit, Inc.

License

MIT

Available Tools

14 tools
get_cite_rocket_overviewA
Read-only

Return member identity, plan access, spendable credits, lifetime usage and billing history in one free request

Inputs: no named parameters.

get_commentsB
Read-only

A post's full comment tree

Inputs: permalink (required).

get_post_by_idA
Read-only

Fetch one post by id

Inputs: id (required).

get_postsC
Read-only

Fetch posts from a subreddit

Inputs: subreddit (required), t, sort, after, +1 more.

get_search_commentsC
Read-only

Search comments

Inputs: q (required), t, nsfw, sort, +2 more.

get_search_communitiesC
Read-only

Search communities

Inputs: q (required), nsfw, after, limit.

get_search_mediaC
Read-only

Search media

Inputs: q (required), t, kind, nsfw, +3 more.

get_search_usersC
Read-only

Search users

Inputs: q (required), nsfw, after, limit.

get_sub_by_name_infoA
Read-only

Subreddit metadata, rules, moderators

Inputs: name (required).

get_sub_by_name_topC
Read-only

A subreddit's top posts

Inputs: name (required), t, after, limit.

get_user_by_nameB
Read-only

User profile and karma

Inputs: name (required).

get_user_by_name_commentsC
Read-only

A user's recent comments

Inputs: name (required), sort, after, limit.

get_user_by_name_statusA
Read-only

Account status / shadowban check

Inputs: name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 14 tools

    Disambiguation4/5

    Most tools target clearly distinct resources (posts, comments, users, subreddits), but get_posts and get_sub_by_name_top both return subreddit posts, and get_search could be confused with the more specific get_search_* variants. Descriptions mostly resolve the ambiguity.

    Naming Consistency4/5

    All tools consistently use the get_ prefix with snake_case, which is predictable. Some names like get_search and get_sub_by_name_top are slightly awkward or less verb-driven, but the overall pattern is coherent.

    Tool Count4/5

    14 tools is on the higher end but reasonable for a Reddit data-access server, especially with separate search endpoints for posts, comments, communities, media, and users. Each tool has a distinct enough role that the count feels justified.

    Completeness3/5

    The server covers the main read-only Reddit workflows: posts, comments, subreddits, users, and search. However, there is no tool for a user's submitted posts (only comments), and subreddit-specific retrieval is limited to top posts rather than hot/new or other common listings.

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides AI assistants with read-only access to Reddit's API for browsing subreddits, reading posts and comments, searching Reddit, and retrieving user/subreddit information. Enables safe exploration of Reddit content without posting capabilities through natural language interactions.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Provides AI assistants with access to Reddit data for searching, browsing subreddits, and retrieving post details or user activity without requiring API keys. It enables tools to fetch content, nested comment trees, and public user feeds directly through the Model Context Protocol.
      6
      192 PyPI
      167
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A read-only Model Context Protocol server that enables browsing subreddits, searching within subreddits, retrieving comment trees, and looking up user activity on Reddit via natural language.
      -