Reddit API tools and examples
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"iflow-mcp-gridfireai-reddit-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Reddit MCP [](https://opensource.org/licenses/MIT) A plug-and-play [MCP](https://modelcontextprotocol.io) server to browse, search, and read Reddit. ## Demo Here's a short video showing how to use this in Claude Desktop: https://github.com/user-attachments/assets/a2e9f2dd-a9ac-453f-acd9-1791380ebdad ## Features - Detailed parameter validation with [pydantic](https://docs.pydantic.dev) - Uses the reliable [PRAW](https://praw.readthedocs.io/) library under the hood - Built-in rate limiting protection thanks to PRAW ## Caveats - Only supports read features for now. If you want to use write features, upvote the [issue](https://github.com/GridfireAI/reddit-mcp/issues/1) or [send a PR](CONTRIBUTING.md)! 🙌 - Tools use tokens. To use this with Claude, you may need to be a Pro user to use many tool calls. Free tier users should be fine with lighter tool usage. Your token usage is your responsibility. ## Installation ### Prerequisite: Reddit API credentials Create a [developer app](https://www.reddit.com/prefs/apps) in your Reddit account if you don't already have one. This will give you a `client_id` and `client_secret` to use in the following steps. If you already have these, you can skip this step. ### Claude Desktop To install into Claude Desktop: - Follow the instructions [here](https://modelcontextprotocol.io/quickstart/user) until the section "Open up the configuration file in any text editor." - Add the following to the file depending on your preferred installation method: ### Using [uvx](https://docs.astral.sh/uv/guides/tools/) (recommended) ```json "mcpServers": { "reddit": { "command": "uvx", "args": ["reddit-mcp"], "env": { "REDDIT_CLIENT_ID": "<client_id>", "REDDIT_CLIENT_SECRET": "<client_secret>" } } } ``` ### Using PIP First install the package: ```bash pip install reddit-mcp ``` Then add the following to the configuration file: ```json "…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.