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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
urlstringThe URL for a 'link' post. Required if `kind` is 'link'.
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 · selftextstringThe markdown-formatted text content for a 'self' post. Required if `kind` is 'self'.
titlestringThe title of the post. Must be 300 characters or less.
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.
subredditstringThe name of the subreddit (without the 'r/' prefix) where the post will be submitted.
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 listing).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
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 the number of comments.one of
relevance · new · top · commentsdefault: relevancelimitintegerThe 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.
mcp-reddit
Reddit MCP — public Reddit data via JSON endpoints (no auth required)
Part of Pipeworx — an MCP gateway connecting AI agents to 673+ live data sources.
Tools
| Tool | Description |
|---|---|
get_subreddit | Get trending posts from a subreddit (e.g., 'python', 'news'). Returns titles, scores, authors, URLs, and comment counts. |
search_posts | Search Reddit posts by keyword or phrase across all subreddits. Returns matching posts with titles, scores, subreddits, authors, and URLs. |
get_post | Get a Reddit post's full content and top-level comments by post ID. Returns text, score, author, subreddit, and comment threads. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"reddit": {
"url": "https://gateway.pipeworx.io/reddit/mcp"
}
}
}
Or connect to the full Pipeworx gateway for access to all 673+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Reddit data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
