search_posts
Search for posts in a Reddit subreddit
LABSCO SUMMARY
One tool answering one question — which posts in this subreddit match this query — and nothing else in the way.
There is no comment fetch, no submission, no user lookup and no cross-subreddit search here; search_posts and its inputs — subreddit, query, sort, count — are the whole configuration, which is the reason to reach for it over a fuller Reddit client. The cost is that the credential setup is the same either way: a Reddit app registration is required before the first call, for a surface that reads one board.
What it is
A Reddit search server whose entire surface is search_posts: name a subreddit, give it a query, choose a sort order and a count, and get the matching posts back.
What you get
- Search scoped to one community at a time: search_posts takes subreddit alongside query, so results come from the board you name rather than from a site-wide index you then have to filter.
- Control of the result set at call time: sort selects the ordering and count caps how much comes back, which keeps a browsing agent from pulling a whole board into context to answer one question.
- A read-only surface by construction: search_posts is the only tool registered, so an agent handed this server gains a way to read a subreddit without gaining a way to write to one.
Requirements
A registered Reddit application, since the server authenticates as one: you need its REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET, plus a REDDIT_USER_AGENT string identifying your client to Reddit.
Setup effort
One command plus credentials — npx -y @enisze/reddit-mcp, then supply credentials
USE CASES
01
Checking what one subreddit is saying about a topic
Point the search at the community that would know, give it the phrase you care about, and cap how much of the board comes back.
1 tool
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool when we connected. Read-only. Every search is scoped to one subreddit, count ranges from 1 to 100 with a default of 25, and requests are spaced two seconds apart.
Requires
- npx on PATH
- REDDIT_CLIENT_ID in your environment
- REDDIT_CLIENT_SECRET in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the one tool definition that rides along on every turn
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @enisze/reddit-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"reddit-mcp": {
"command": "npx",
"args": [
"-y",
"@enisze/reddit-mcp"
],
"env": {
"REDDIT_CLIENT_ID": "<YOUR_REDDIT_CLIENT_ID>",
"REDDIT_CLIENT_SECRET": "<YOUR_REDDIT_CLIENT_SECRET>",
"REDDIT_USER_AGENT": "reddit-mcp-server/1.0.0"
}
}
}
}
