search_posts

Active

declared in 0.1.0

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, title, author, subreddit, permalink, and date.

Parameters schema

{
  "type": "object",
  "examples": [
    {
      "query": "machine learning"
    },
    {
      "sort": "top",
      "limit": 50,
      "query": "climate change"
    }
  ],
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "type": "string",
      "description": "relevance (default), hot, top, new, comments."
    },
    "limit": {
      "type": "number",
      "description": "Number of results (default 10, max 100)."
    },
    "query": {
      "type": "string",
      "description": "Search query."
    },
    "subreddit": {
      "type": "string",
      "description": "Optional subreddit to restrict the search to (e.g. \"python\")."
    }
  }
}

What this tool wraps· 1 endpoint

min confidence0.70 0.50

Data resourceReddit API
Reddit · media
name mention0.75

Parent server

https://github.com/pipeworx-io/mcp-reddit

1/7 registries

View full server →