`get_post`

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

Get a Reddit post’s full content and top-level comments by post ID. Returns text, score, author, subreddit, and comment threads.

Parameters

Name	Type	Required	Description
`post_id`	string	yes	Reddit post ID (the alphanumeric ID, 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

{
  "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