`get_post`

Pack: reddit · Endpoint: https://gateway.pipeworx.io/reddit/mcp

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

Name	Type	Required	Description
`post_id`	string	yes	Reddit post ID (alphanumeric, e.g. “abc123”).

Example call

Arguments

{
  "post_id": "abc123def456"
}

curl

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

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_post', {
  "post_id": "abc123def456"
});

Response shape

Full JSON Schema

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "post": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "description": "Post ID"
            },
            "title": {
              "type": "string",
              "description": "Post title"
            },
            "subreddit": {
              "type": "string",
              "description": "Subreddit name"
            },
            "author": {
              "type": "string",
              "description": "Post author"
            },
            "score": {
              "type": "number",
              "description": "Upvote score"
            },
            "url": {
              "type": "string",
              "description": "Post URL"
            },
            "permalink": {
              "type": "string",
              "description": "Full Reddit permalink"
            },
            "num_comments": {
              "type": "number",
              "description": "Number of comments"
            },
            "created_utc": {
              "type": "number",
              "description": "Creation timestamp (UTC)"
            },
            "is_self": {
              "type": "boolean",
              "description": "Is self-post"
            },
            "selftext": {
              "type": [
                "string",
                "null"
              ],
              "description": "Self-post text content"
            },
            "flair": {
              "type": [
                "string",
                "null"
              ],
              "description": "Link flair text"
            }
          },
          "required": [
            "id",
            "title",
            "subreddit",
            "author",
            "score",
            "url",
            "permalink",
            "num_comments",
            "created_utc",
            "is_self",
            "selftext",
            "flair"
          ]
        },
        "comments": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Comment ID"
              },
              "author": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Comment author"
              },
              "body": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Comment text"
              },
              "score": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Comment upvote score"
              },
              "created_utc": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Creation timestamp (UTC)"
              }
            },
            "required": [
              "id",
              "author",
              "body",
              "score",
              "created_utc"
            ]
          }
        }
      },
      "required": [
        "post",
        "comments"
      ]
    },
    {
      "type": "object",
      "properties": {
        "post_id": {
          "type": "string",
          "description": "Post ID requested"
        },
        "reason": {
          "type": "string",
          "enum": [
            "reddit_blocked",
            "reddit_rate_limited",
            "not_found"
          ],
          "description": "Failure reason"
        },
        "message": {
          "type": "string",
          "description": "Failure message"
        },
        "hint": {
          "type": "string",
          "description": "Optional hint for recovery"
        }
      },
      "required": [
        "post_id",
        "reason",
        "message"
      ]
    }
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "reddit": {
      "url": "https://gateway.pipeworx.io/reddit/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_post