Tools

get_subredditrequired: subreddit

Get posts from a REDDIT subreddit — r/LocalLLaMA, r/python, r/news. PREFER for "what are people posting in r/<sub>", "whats new on r/<sub> today", "top posts on Reddit this week". Sorted hot (default)

Parameters

NameTypeDescription

subredditreqstringSubreddit name without the r/ prefix (e.g. "programming")

limitoptnumberNumber of posts to return (default: 10, max: 100)

▶Try it

Response

search_postsrequired: query

Search Reddit posts by keyword — across all subreddits, or scoped to one via the subreddit argument ("search r/<sub> for X"). Sort by relevance (default), hot, top, new, or comments. Returns post id,

Parameters

NameTypeDescription

queryreqstringSearch query

limitoptnumberNumber of results to return (default: 10, max: 100)

sortoptstringSort order: relevance, hot, top, new, comments (default: relevance)

▶Try it

Response

get_postrequired: post_id

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.

Parameters

NameTypeDescription

post_idreqstringReddit post ID (the alphanumeric ID, e.g. "abc123")

▶Try it

Response

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools

bash

curl -X POST https://gateway.pipeworx.io/reddit/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool

bash

curl -X POST https://gateway.pipeworx.io/reddit/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_subreddit","arguments":{"subreddit": "example"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript

import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("get_subreddit", {"subreddit":"example"});

ask_pipeworx

// Or ask in plain English:
const answer = await px.ask("read public reddit posts, search across subreddits, and fetch post comments");

Related packs

Other Pipeworx packs in the same categories (Social, News, Media):

MCP Config

claude_desktop_config.json

{
  "mcpServers": {
    "pipeworx-reddit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gateway.pipeworx.io/reddit/mcp"
      ]
    }
  }
}