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

reddit_search_posts

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,

No parameters required.

▶Try it

Response

reddit_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.

No parameters required.

▶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"
      ]
    }
  }
}