Reddit MCP
Connect Claude Desktop, Claude Code, Cursor, Windsurf or any MCP client to Reddit with one npx command. Open source, 14 read-only Reddit tools, one CiteRocket API key.
$ npx -y @citerocket/reddit-mcp@latestLast updated 22 September 2026. Figures re-verified against npm and the live tool manifest on that date.
A Reddit MCP server is a Model Context Protocol server whose tools read Reddit. When an MCP client such as Claude Desktop or Cursor starts it, the client discovers those tools and the model can call them mid-conversation: fetch a subreddit's top posts, search comments, pull a full comment tree or check an account's status. @citerocket/reddit-mcp is CiteRocket's open-source implementation. It runs on your machine under npx, loads its 14 read-only tools from a hosted manifest, and sends each call to the CiteRocket API with your key. You never create a Reddit OAuth app or file an application with Reddit; CiteRocket handles the Reddit side.
Official or third-party?
Not that we, Google's AI Overview or Perplexity could find as of 22 September 2026. Reddit's developer platform does not publish one, so every Reddit MCP server, including this one, is third-party. Ours is built by CiteRocket on its own Reddit API rather than on Reddit's Data API.
Reddit API keys?
No. Most community servers need a Reddit app client ID and secret, and a username and password for full data or writes, which since November 2025 means applying to Reddit, and from 31 October 2026 Reddit no longer accepts new requests. This one needs a single CiteRocket key; the Reddit access happens on CiteRocket's side.
Free? On GitHub?
The server is free and MIT-licensed, published on npm with the source on GitHub. Tool calls spend CiteRocket credits: 1 credit per read, the account overview free, and 1,000 free credits at signup with no card.
Local, not cloud: the server runs on your machine under npx and needs Node.js. The tools come from the hosted manifest, so there is nothing to build. Three steps.
01 / Key
Sign up and copy your API key from the dashboard. It starts with cite_live_. Every account gets 1,000 free credits, no card.
02 / Config
Add the server to your client's MCP config with the key in CITEROCKET_API_KEY. The JSON below is the same for Claude Desktop, Cursor and Windsurf.
03 / Restart
Restart the client. The 14 tools appear in its tool list, and a prompt like "find the top posts in r/selfhosted this week" calls them.
{
"mcpServers": {
"citerocket": {
"command": "npx",
"args": ["-y", "@citerocket/reddit-mcp@latest"],
"env": { "CITEROCKET_API_KEY": "cite_live_..." }
}
}
}claude mcp add citerocket -e CITEROCKET_API_KEY=cite_live_... -- npx -y @citerocket/reddit-mcp@latestConfig verbatim from the package README. Never commit a real key; keep it in the client config or your environment.
Names and descriptions below are copied from https://api.citerocket.com/mcp/manifest, which the server reads at startup. All are read-only.
Posts and subreddits
get_postsFetch posts from a subredditget_post_by_idFetch one post by idget_commentsA post's full comment treeget_sub_by_name_topA subreddit's top postsget_sub_by_name_infoSubreddit metadata, rules, moderatorsSearch
get_searchSearch posts across Redditget_search_commentsSearch commentsget_search_communitiesSearch communitiesget_search_mediaSearch mediaget_search_usersSearch usersUsers
get_user_by_nameUser profile and karmaget_user_by_name_commentsA user's recent commentsget_user_by_name_statusAccount status check (active, suspended, banned)Account
get_cite_rocket_overviewYour plan, credits, usage and billing in one free requestNeed to comment or vote? Login, comment and vote are marked coming soon on the HTTP API and are not MCP tools. Because the server loads its list from the manifest, new tools appear without a reinstall.
Anything the tools cover. Each prompt below maps to the manifest tool the model will call; the results come back as structured data the model can quote.
| You ask | Tool the model calls |
|---|---|
| "What are the top posts in r/selfhosted this week?" | get_sub_by_name_top |
| "Find Reddit threads recommending a CRM for a small agency." | get_search |
| "Summarise the discussion under this post." | get_comments |
| "Which subreddits talk about home battery storage?" | get_search_communities |
| "Is u/example still active or banned, and what have they posted recently?" | get_user_by_name_status, get_user_by_name_comments |
| "How many credits do I have left?" | get_cite_rocket_overview |
What the package does between your client and Reddit.
At startup the server fetches the tool list from the hosted manifest and falls back to a bundled copy if the API is unreachable. Its only dependency is the official MCP SDK.
Every tool call is one HTTP request to api.citerocket.com with your key as a Bearer token, metered in credits and visible in your dashboard. A read costs 1 credit.
The server is MIT-licensed on GitHub. Read the code, fork it, or pin a version. It was published on 12 September 2026.
It depends on what the agent must do. @citerocket/reddit-mcp gives full read data on every tool with one CiteRocket key and no Reddit approval. Community servers on Reddit's Data API can post or edit from your own account, but need Reddit app credentials, which since November 2025 means applying to Reddit.
| Feature | @citerocket/reddit-mcp | reddit-mcp-buddy | jordanburke/reddit-mcp-server |
|---|---|---|---|
| Credentials | One CiteRocket API key. | None for basic browsing; Reddit client ID, secret, username and password for full data. | None for anonymous reads; Reddit client ID and secret for authenticated reads; username and password for writes. |
| Reddit approval needed | No. | New requests closed 31 October 2026; Reddit says public access ends March 2027. | New requests closed 31 October 2026; Reddit says public access ends March 2027. |
| Read data without credentials | Full data on all 14 tools. | One tool via the public RSS feed; score, comment count and upvote ratio come back null. | Anonymous read-only mode. |
| Writes from the agent | None; writes are on the HTTP API. | None; read-only by design. | Create, reply, edit and delete posts and comments with user credentials. Voting deliberately excluded. |
| Rate ceiling | 2 QPS free, up to 50 QPS on paid plans. | 10, 60 or 100 requests per minute by credential tier. | Reddit's Data API limits (100 requests per minute on the free tier). |
| Cost | 1 credit per read; 1,000 free credits; plans from $19/month. | Free; Reddit free tier is non-commercial. | Free; Reddit free tier is non-commercial. |
| Where it runs | Locally under npx; tools load from a hosted manifest. | Locally under npx. | Locally under npx or Docker. |
| Licence | MIT | Open source on GitHub. | Open source on GitHub. |
Competitor rows are from the projects' own READMEs on GitHub, read 22 September 2026: reddit-mcp-buddy and jordanburke/reddit-mcp-server. Reddit's free tier is 100 requests per minute with OAuth, verified 2026-09-16; the approval requirement is from Reddit's November 2025 announcement. Both projects are good work; the difference is where the Reddit credentials live.
MCP is an open standard, introduced by Anthropic, that lets AI models connect to external tools and data through one interface. A server describes its tools; any MCP client can call them. A Reddit Model Context Protocol server is simply one whose tools read Reddit.
Sources: the official Model Context Protocol documentation and Anthropic's MCP announcement.
Every MCP tool is a documented endpoint. Here is the search tool as a plain request, with the same key.
curl "https://api.citerocket.com/api/reddit/search?q=best+crm&sort=top" \
-H "Authorization: Bearer $CITEROCKET_API_KEY"Yes, several, all third-party. @citerocket/reddit-mcp is CiteRocket's: an open-source Reddit MCP server with 14 read-only tools that runs under npx and needs only a CiteRocket key. Community servers on GitHub work directly against Reddit's Data API and need Reddit app credentials for full access.
Claude Desktop: add @citerocket/reddit-mcp to the mcpServers section of claude_desktop_config.json with your key in CITEROCKET_API_KEY, then restart. Claude Code: run the one-line claude mcp add command in the setup section. Both run the server locally under npx; nothing is hosted in the cloud for you to connect to.
Not from MCP. Every tool in the current manifest is read-only; login, commenting and voting are planned HTTP API operations, marked coming soon in the docs. Voting and karma manipulation are prohibited by our acceptable use policy and by Reddit's rules regardless of the route, so no vote tool will be added to the MCP server.
No. The server authenticates with a single CiteRocket API key set in the CITEROCKET_API_KEY environment variable. CiteRocket handles Reddit access behind it; there is no OAuth app to create and no application to Reddit.
The package is free and open source under the MIT licence, on npm and GitHub. Tool calls spend credits from your CiteRocket plan: a read costs 1 credit, the account overview is free, and per-plan rate ceilings apply (2 QPS free, 10, 25, 50 QPS on paid plans). New accounts start with 1,000 free credits and no card.
It depends on what the agent must do. For reads without Reddit credentials or approval, with full data on every tool, use @citerocket/reddit-mcp. For posting or editing from the agent with your own Reddit account, jordanburke/reddit-mcp-server supports that with user credentials. The comparison table on this page lists the verified differences.
Yes. Every tool maps to a documented HTTP endpoint, so the same capabilities work with OpenAI function calling, Claude tool use, LangChain, or a plain fetch from your own agent loop.
The Reddit MCP server: one npx command, one API key, 14 Reddit tools. Plans from $19/month, 1,000 free credits to start.