CiteRocket MCP
OfficialUse CiteRocket MCP as a read-only Reddit API bridge for MCP clients like Claude and Cursor.
Fetch posts from a subreddit with sorting, timeframes, pagination, and limits.
Search Reddit posts, comments, communities, media, and users, with filters like NSFW, sort, timeframe, and media kind.
Get a subreddit's top posts or its metadata, rules, and moderators.
Fetch one post by ID and retrieve a post's full comment tree by permalink.
Look up user profiles/karma, recent comments, and account status/shadowban checks.
Check your CiteRocket credits, usage, plan access, and billing overview for free.
All tools are read-only; normal calls are metered as CiteRocket API usage.
Provides tools for interacting with Reddit's API, enabling searching posts and comments, retrieving subreddit posts and metadata, reading full comment trees, and looking up user profiles, karma, and account status.
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., "@CiteRocket MCP What are the top posts on r/programming this week?"
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.
Reddit MCP: the Reddit API for Claude, Cursor and any MCP client
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@latestRelated 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 |
| Fetch posts from a subreddit |
| Search posts across Reddit |
| A post's full comment tree |
| Fetch one post by id |
| A subreddit's top posts |
| Subreddit metadata, rules, moderators |
| User profile and karma |
| A user's recent comments |
| Account status / shadowban check |
| Search communities |
| Search comments |
| Search media |
| Search users |
| 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 |
| yes | Your API key, sent as |
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/Links
🌐 Website: citerocket.com
📚 API docs: citerocket.com/docs
🔑 Get an API key: app.citerocket.com
📈 Status: citerocket.com/status
✉️ Support: support@citerocket.com
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 toolsget_cite_rocket_overviewARead-only
Return member identity, plan access, spendable credits, lifetime usage and billing history in one free request
Inputs: no named parameters.
get_commentsBRead-only
A post's full comment tree
Inputs: permalink (required).
get_post_by_idARead-only
Fetch one post by id
Inputs: id (required).
get_postsCRead-only
Fetch posts from a subreddit
Inputs: subreddit (required), t, sort, after, +1 more.
get_searchARead-only
Search posts across Reddit
Inputs: q (required), t, nsfw, sort, +3 more.
get_search_commentsCRead-only
Search comments
Inputs: q (required), t, nsfw, sort, +2 more.
get_search_communitiesCRead-only
Search communities
Inputs: q (required), nsfw, after, limit.
get_search_mediaCRead-only
Search media
Inputs: q (required), t, kind, nsfw, +3 more.
get_search_usersCRead-only
Search users
Inputs: q (required), nsfw, after, limit.
get_sub_by_name_infoARead-only
Subreddit metadata, rules, moderators
Inputs: name (required).
get_sub_by_name_topCRead-only
A subreddit's top posts
Inputs: name (required), t, after, limit.
get_user_by_nameBRead-only
User profile and karma
Inputs: name (required).
get_user_by_name_commentsCRead-only
A user's recent comments
Inputs: name (required), sort, after, limit.
get_user_by_name_statusARead-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
Scored across 14 tools
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.
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.
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.
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
Related MCP Connectors
Query Reddit communities, posts, brands and trends from your AI agent. OAuth 2.1.
Read-only Reddit search API for AI agents: posts, comments, comment trees, subreddit rules.
Search public Reddit posts, browse subreddit feeds, and read posts, comments, and profiles.
Reddit posts, comments, keyword search and historical archives as tools. Runs on Apify.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides 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.-
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to interact with Reddit by searching subreddits, retrieving hot posts, and fetching detailed post information with comments through the Reddit API.-
- AlicenseAqualityBmaintenanceProvides 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.6192 PyPI167MIT
- FlicenseNot gradedqualityDmaintenanceA 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.-