Summary
Pulls public Reddit data through JSON endpoints without requiring authentication. Exposes three tools: get_subreddit for trending posts from specific communities, search_posts for keyword queries across all of Reddit, and get_post for retrieving full content plus top-level comments by post ID. Returns structured data including titles, scores, authors, URLs, and comment counts. Part of the Pipeworx gateway ecosystem, so you can either connect to this standalone Reddit server or access it alongside 250+ other data sources through their unified gateway. Useful when you need to scan trending discussions, search for mentions, or pull comment threads into your AI workflow.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
10 tools
REDDIT_CREATE_REDDIT_POSTCreates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair.6 params
Creates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair.
Parameters* required
flair_idstringOptional ID of the flair to apply to the post. Use the 'REDDIT_GET_USER_FLAIR' action to find available flair IDs for the specified subreddit. Omit this field entirely if no flair is needed.
kindstringThe type of the post. Use 'self' for a text-based post or 'link' for a post that links to an external URL.one of
link · selfsubredditstringThe name of the subreddit (without the 'r/' prefix) where the post will be submitted.
textstringThe markdown-formatted text content for a 'self' post. Required if `kind` is 'self'.
titlestringThe title of the post. Must be 300 characters or less.
urlstringThe URL for a 'link' post. Required if `kind` is 'link'.
REDDIT_DELETE_REDDIT_COMMENTDeletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user.1 params
Deletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user.
Parameters* required
idstringThe full 'thing ID' (fullname, e.g., 't1_c0s4w1c') of the comment to delete; typically starts with 't1_'.
REDDIT_DELETE_REDDIT_POSTPermanently deletes a Reddit post by its ID, provided the authenticated user has deletion permissions for that post.1 params
Permanently deletes a Reddit post by its ID, provided the authenticated user has deletion permissions for that post.
Parameters* required
idstringThe full name (fullname) of the Reddit post to be deleted. This ID must start with 't3_' followed by the post's unique base36 identifier.
REDDIT_EDIT_REDDIT_COMMENT_OR_POSTEdits the body text of the authenticated user's own existing comment or self-post on Reddit; cannot edit link posts or titles.2 params
Edits the body text of the authenticated user's own existing comment or self-post on Reddit; cannot edit link posts or titles.
Parameters* required
textstringThe new raw markdown text for the body of the comment or self-post.
thing_idstringThe full name (fullname) of the comment or self-post to edit. This is a combination of a prefix (e.g., 't1_' for comment, 't3_' for post) and the item's ID.
REDDIT_GET_USER_FLAIRFetches the list of available link flairs (i.e., post flairs, not user flairs) for a given subreddit.1 params
Fetches the list of available link flairs (i.e., post flairs, not user flairs) for a given subreddit.
Parameters* required
subredditstringName of the subreddit (e.g., 'pics', 'gaming') for which to retrieve available link flairs.
REDDIT_POST_REDDIT_COMMENTPosts a comment on Reddit, replying to an existing and accessible submission (post) or another comment.2 params
Posts a comment on Reddit, replying to an existing and accessible submission (post) or another comment.
Parameters* required
textstringThe raw Markdown text of the comment to be submitted.
thing_idstringThe ID of the parent post (link) or comment, prefixed with 't3_' for a post (e.g., 't3_10omtdx') or 't1_' for a comment (e.g., 't1_h2g9w8l').
REDDIT_RETRIEVE_POST_COMMENTSRetrieves all comments for a Reddit post given its article ID (which must be for an existing, public post); nested replies within comments are returned as raw dictionaries requiring parsing.1 params
Retrieves all comments for a Reddit post given its article ID (which must be for an existing, public post); nested replies within comments are returned as raw dictionaries requiring parsing.
Parameters* required
articlestringBase-36 ID of the Reddit post (e.g., 'q5u7q5'), typically found in the post's URL and not including the 't3_' prefix.
REDDIT_RETRIEVE_REDDIT_POSTRetrieves the current hot posts from a specified, publicly accessible subreddit.2 params
Retrieves the current hot posts from a specified, publicly accessible subreddit.
Parameters* required
sizeintegerThe maximum number of posts to return. Default is 5. Set to 0 to retrieve all available posts (or the maximum allowed by the Reddit API for a single request, typically up to 100 for this type of li...default: 5
subredditstringThe name of the subreddit from which to retrieve posts (e.g., 'popular', 'pics'). Do not include 'r/'.
REDDIT_RETRIEVE_SPECIFIC_COMMENTRetrieves detailed information for a specific Reddit comment or post using its fullname.1 params
Retrieves detailed information for a specific Reddit comment or post using its fullname.
Parameters* required
idstringFullname of the comment or post to retrieve (e.g., 't1_c123456', 't3_x56789').
REDDIT_SEARCH_ACROSS_SUBREDDITSSearches Reddit for content (e.g., posts, comments) using a query, with results typically confined to subreddits unless `restrict_sr` is set to False.4 params
Searches Reddit for content (e.g., posts, comments) using a query, with results typically confined to subreddits unless `restrict_sr` is set to False.
Parameters* required
limitintegerThe maximum number of search results to return. Default is 5. Maximum allowed value is 100.default: 5
restrict_srbooleanIf True (default), confines the search to posts and comments within subreddits. If False, the search scope is broader and may include matching subreddit names or other Reddit entities.default: true
search_querystringThe search query string used to find content across subreddits.
sortstringThe criterion for sorting search results. 'relevance' (default) sorts by relevance to the query. 'new' sorts by newest first. 'top' sorts by highest score (typically all-time). 'comments' sorts by...one of
relevance · new · top · commentsdefault: relevancemcp-reddit
Reddit MCP — public Reddit data via the Atom/RSS feeds.
Part of Pipeworx — an MCP gateway connecting AI agents to 1476+ live data sources.
Tools
| Tool | Description |
|---|---|
get_subreddit | Get posts from a REDDIT subreddit — r/LocalLLaMA, r/python, r/news. PREFER for "what are people posting in r/", "whats new on r/ today", "top posts on Reddit this week". Sorted hot (default), new, top, rising, or controversial. For "top"/"controversial" pass a time window (day/week/month/year/all) — e.g. "top posts in r/programming this week". Returns post id, title, author, permalink, date, and a body snippet. (Vote score and comment count are not available via Reddit RSS.) |
search_posts | Search Reddit posts by keyword — across all subreddits, or scoped to one via the subreddit argument ("search r/ for X"). Sort by relevance (default), hot, top, new, or comments. Returns post id, title, author, subreddit, permalink, and date. |
get_post | Get a Reddit post and its comments by post ID. Returns the post (title, author, body, permalink) and the comment threads (author, body, date). Vote scores aren't available via Reddit RSS. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"reddit": {
"url": "https://gateway.pipeworx.io/reddit/mcp"
}
}
}
What this endpoint actually serves
tools/list at https://gateway.pipeworx.io/reddit/mcp returns the tools in the table
above plus the shared Pipeworx meta-tools — ask_pipeworx,
discover_tools, search_within, remember/recall and the rest of the
gateway-wide set. So the tool count you see is larger than this table: a
single-pack endpoint currently lists roughly 30 shared tools alongside the
pack's own. The connection's initialize response states its exact scope, and
is the authoritative answer for a given day.
This is deliberate, not multiplexing by accident. The meta-tools are what let a
scoped connection answer a question this pack does not cover — via
ask_pipeworx, which routes across the whole catalog — without you adding a
second MCP server. There is currently no way to mount a pack endpoint without
them; if the extra schemas cost you more context than the routing is worth,
connect to the full gateway once rather than to several pack endpoints.
Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Both URLs reach the same gateway and the same 1476+ data sources. The
only difference is which pack's tools are listed directly; ask_pipeworx
reaches all of them from either one.
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:
ask_pipeworx({ question: "your question about Reddit data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
