The Reddit MCP server: 44 tools, one line

By the numbers

What the server gives an agent

Every figure below is read from the system that emits it: the tool count from the published server catalog, the endpoint count from the API route table, and the price from the rate card the API bills against. Nothing here is an estimate, and each number changes on this page the moment the source changes.

Install

Install it in your MCP client

The server is the same everywhere: npx starts redditapis-mcp and it reads your key from the environment. What changes per client is the config file, the key the servers live under, and whether a restart is needed. Pick your client below; the full guide for each one walks through every step and how to confirm the tools loaded.

// macOS:   ~/Library/Application Support/Claude/claude_desktop_config.json
// Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "redditapis-mcp@latest"],
      "env": { "REDDITAPIS_KEY": "YOUR_KEY" }
    }
  }
}

# local scope (this project only, the default)
claude mcp add reddit \
  --env REDDITAPIS_KEY=YOUR_KEY \
  -- npx -y redditapis-mcp@latest

# project scope: writes a shared .mcp.json for the team
claude mcp add reddit --scope project \
  --env REDDITAPIS_KEY=YOUR_KEY \
  -- npx -y redditapis-mcp@latest

// global:  ~/.cursor/mcp.json      project:  .cursor/mcp.json
{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "redditapis-mcp@latest"],
      "env": { "REDDITAPIS_KEY": "YOUR_KEY" }
    }
  }
}

// .vscode/mcp.json
{
  "inputs": [
    {
      "id": "redditapis-key",
      "type": "promptString",
      "description": "Redditapis API key",
      "password": true
    }
  ],
  "servers": {
    "reddit": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "redditapis-mcp@latest"],
      "env": { "REDDITAPIS_KEY": "${input:redditapis-key}" }
    }
  }
}

// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "redditapis-mcp@latest"],
      "env": { "REDDITAPIS_KEY": "YOUR_KEY" }
    }
  }
}

// kilo.jsonc at your project root
{
  "mcp": {
    "reddit": {
      "type": "local",
      "command": ["npx", "-y", "redditapis-mcp@latest"],
      "environment": { "REDDITAPIS_KEY": "YOUR_KEY" },
      "enabled": true
    }
  }
}

// ~/.openclaw/openclaw.json
{
  "mcp": {
    "servers": {
      "reddit": {
        "command": "npx",
        "args": ["-y", "redditapis-mcp@latest"],
        "env": { "REDDITAPIS_KEY": "YOUR_KEY" }
      }
    }
  }
}

# ~/.hermes/config.yaml
mcp_servers:
  reddit:
    command: "npx"
    args: ["-y", "redditapis-mcp@latest"]
    env:
      REDDITAPIS_KEY: "YOUR_KEY"

{
  "command": "npx",
  "args": ["-y", "redditapis-mcp@latest"],
  "env": { "REDDITAPIS_KEY": "YOUR_KEY" }
}

Tools

All 44 tools, what each one does and costs

This table is checked against the published tool catalog on every commit, so a tool added or removed from the server shows up here or blocks the change. 30 tools read Reddit; 5 of those read your own account and need your Reddit session. The 7 write tools change your own Redditapis account only, never Reddit.

Try it

Example prompts that work on day one

You do not call the tools yourself. Ask in plain language and the client picks the tool, fills the arguments and pages with the returned cursor. These prompts are written for the tools as they exist today, and the second column names which tools the model usually reaches for, so you can see what each request costs.

Use cases

What teams build with it

The server is most useful where an agent needs current Reddit context and a source it can cite, not a summary from last year's training data. These are the patterns the tool set was built around, from one-off research questions in Claude Desktop to scheduled monitors that push matches into a team channel.

Auth and pricing

One key, billed per call

The server sends your key as a bearer token on every call and holds no state of its own. There is no subscription for the reads: each call is billed from your credit balance at the published rate, and a failed call that returns 429 or 503 is not billed. Monitoring is the one part sold as a monthly plan, for teams that want matches pushed to them.

Full rate card and monitoring plans: pricing. Model a workload first with the cost calculator.

Rate limits

Rate limits, and what a 429 means here

The Reddit data endpoints behind the tools have no fixed per-key request quota, so a fixed requests-per-minute throttle in your agent only slows it down. When Reddit limits one account in the read pool, the API rotates and retries; you only see a 429 when that whole chain is exhausted, and it is not billed.

Cap concurrency rather than rate, back off from Retry-After with jitter, and treat 503 the same way. Source: the rate limits docs.

Compare

Versus Apify's Reddit actors and self-hosted servers

Three ways to put Reddit behind MCP show up when you search for one. Every competitor fact in this table was read from that product's own page on 2026-09-24 and is linked below the table, so you can check it yourself. Where we could not confirm something, it is not in the table.

Sources, read 2026-09-24: Apify Reddit MCP server, trudax/reddit-scraper, Apify pricing, jordanburke/reddit-mcp-server. A generic scraping API is a fourth route: it returns reddit.com pages, and turning those into posts, comment trees and cursors is code you write and maintain. The longer comparison is on the Apify alternative page.

Troubleshooting

Symptom, cause and fix

Most setup problems are one of a handful of causes: invalid config, a missing key, an empty balance, a session-only tool called without a session, or a long call hitting the default timeout. Match what you see to the left column. Anything that is not on this list, the server can draft into a feedback report for you to review and send.

Docs

Docs, llms.txt and the source

If your agent reads documentation before it acts, point it at llms.txt: it lists every public page and endpoint in plain text. The REST reference documents each endpoint a tool calls, with parameters and response fields, and the npm package carries the tool catalog and changelog for the exact version you run.

• llms.txt , the site index for agents
• llms-full.txt , the full-text version
• API reference , every endpoint behind the tools
• redditapis-mcp on npm , README, catalog and changelog
• Source on GitHub , MIT licensed
• Reddit agent skill , pairing the tools with a skill file

Frequently asked questions

Related pages

New to MCP, or deciding between calling the API directly and going through an agent? These pages cover the concept, the trade-offs and the neighbouring products, so this hub can stay focused on installing and running the server.

• What a Reddit MCP server is , the concept and why wrap Reddit as tools
• MCP vs REST API for agents , when to use which
• Remote vs self-hosted , transport and auth in production
• Reddit API for AI agents , the wider agent use case
• Reddit monitoring API , the monitors behind the 10 tools
• Quickstart , the first REST call in a minute