Reddit MCP

Instructions

Retrieve a specific submission by ID.

Args:
    submission_id: ID of the submission to retrieve

Returns:
    Detailed information about the submission

Implementation Reference

• src/reddit_mcp/tools/get_submission.py:19-42 (handler)

  The main handler function that implements the 'get_submission' tool logic: fetches a Reddit submission by ID using RedditClient and returns formatted data as SubmissionResult.

  @validate_call(validate_return=True)
  def get_submission(submission_id: str) -> SubmissionResult:
      """
      Retrieve a specific submission by ID.
  
      Args:
          submission_id: ID of the submission to retrieve
  
      Returns:
          Detailed information about the submission
      """
      client = RedditClient.get_instance()
      submission = client.reddit.submission(submission_id)
  
      return SubmissionResult(
          title=submission.title,
          url=submission.url,
          author=None if submission.author is None else submission.author.name,
          subreddit=submission.subreddit.display_name,
          score=submission.score,
          num_comments=submission.num_comments,
          selftext=submission.selftext,
          created_utc=format_utc_timestamp(submission.created_utc),
      )

• src/reddit_mcp/tools/get_submission.py:6-17 (schema)

  Pydantic BaseModel defining the output schema for the get_submission tool.

  class SubmissionResult(BaseModel):
      """Reddit submission details"""
  
      title: str = Field(description="Title of the submission")
      url: str = Field(description="URL of the submission")
      author: str | None = Field(description="Username of the author, or None if deleted")
      subreddit: str = Field(description="Name of the subreddit")
      score: int = Field(description="Number of upvotes minus downvotes")
      num_comments: int = Field(description="Number of comments on the submission")
      selftext: str = Field(description="Text content of the submission")
      created_utc: str = Field(description="UTC timestamp when submission was created")

• src/reddit_mcp/tools/__init__.py:1-24 (registration)

  Imports get_submission and includes it in the __all__ and 'tools' list, which is used for registering tools to the MCP server.

  from .get_submission import get_submission
  from .get_subreddit import get_subreddit
  from .get_comments import get_comments_by_submission, get_comment_by_id
  from .search_posts import search_posts
  from .search_subreddits import search_subreddits
  
  __all__ = [
      "get_submission",
      "get_subreddit",
      "get_comments_by_submission",
      "get_comment_by_id",
      "search_posts",
      "search_subreddits",
  ]
  
  # Registry of all available tools
  tools = [
      get_submission,
      get_subreddit,
      get_comments_by_submission,
      get_comment_by_id,
      search_posts,
      search_subreddits,
  ]

• src/reddit_mcp/server.py:1-16 (registration)

  The MCP server setup function that imports the 'tools' list and registers each tool (including get_submission) to the FastMCP instance.

  from mcp.server.fastmcp import FastMCP
  from .tools import tools
  import logging
  
  
  def serve():
      logger = logging.getLogger("mcp")
  
      mcp = FastMCP("Reddit")
  
      for tool in tools:
          logger.info(f"Registering tool: {tool.__name__}")
          mcp.tool()(tool)
  
      logger.info("Starting MCP server...")
      mcp.run(transport="stdio")