# Reddit MCP Server (`techforce.global/reddit-posts-mcp-server`) Actor Model Context Protocol (MCP) server for Reddit. Search posts, read subreddit listings, fetch posts with comments, profile users, and discover trending communities — straight from your AI agent. - **URL**: https://apify.com/techforce.global/reddit-posts-mcp-server.md - **Developed by:** [Techforce Global](https://apify.com/techforce.global) (community) - **Categories:** MCP servers, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $5.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Reddit Posts Scraper + MCP Connector Delivery Scrape Reddit — search results, subreddit listings, or a single post with its full comment thread — and **deliver every result straight into the apps you already use** via MCP connectors: Notion, Slack, Linear, Airtable, Jira, GitHub, and more. No glue code, no webhooks to maintain. > **Scrape Reddit → drop it into Notion, Slack, or Linear automatically.** --- ### ⭐ Features - **3 scrape modes** — search Reddit, list a subreddit, or pull a single post with comments. - **Deliver anywhere via MCP connectors** — pick any connector you've authorized; the Actor calls its tools for you. - **Per-post or summary delivery** — one message per post, or a single rolled-up summary. - **Templated messages** — compose the payload with `{title}`, `{author}`, `{permalink}`, and more. - **Clean, structured output** — flat JSON with ISO-8601 timestamps and absolute permalinks, stored in the dataset. - **Credentials stay private** — delivery runs through the Apify MCP Proxy; the Actor never sees your connector tokens. ### 🎯 Use Cases - **Research → Notion** — push posts about your product or niche into a Notion database. - **Monitoring → Slack** — drop new top posts from a subreddit into a Slack channel. - **Triage → Linear/Jira** — turn relevant complaints or bug reports into tickets. - **Archiving → Airtable/Sheets** — keep a structured log of Reddit discussions. ### 🚀 How to Use 1. **Choose a scrape mode** and fill the matching fields (query, subreddit, or post URL). 2. **(Optional) Pick an MCP connector** as the delivery target — or leave it empty to just collect data. 3. **Set the connector tool** (e.g. `create_page`, `send_message`) and its arguments. 4. **Run.** Results land in the dataset and, if a connector is set, in your app. > 💡 First time with a connector? Run once with delivery on — the run log prints the connector's available tool names so you know what to put in **Connector tool name**. ### 🧩 Input Configuration | Field | Type | Description | |---|---|---| | `mode` | enum | `search`, `subreddit`, or `post`. | | `searchQuery` / `searchScopeSubreddit` | string | Search terms and optional subreddit scope (search mode). | | `subreddit` | string | Subreddit name without `r/` (subreddit mode). | | `postUrl` | string | Post URL or id (post mode). | | `sort` / `time` / `limit` | enum/int | Ordering, time window, and max posts (1–100). | | `maxComments` | int | Comments to include in post mode (0–500). | | `redditClientId` / `redditClientSecret` | string | **Recommended.** Reddit app credentials for the official API (avoids 403 blocks). See below. | | `proxyConfiguration` | object | Apify Proxy. **RESIDENTIAL** recommended. | | `mcpConnector` | connector | Delivery target — any authorized MCP connector. | | `deliveryMode` | enum | `perPost`, `summary`, or `none`. | | `mcpTool` | string | Tool to call on the connector. | | `mcpArguments` | object | Tool arguments; string values support `{placeholders}`. | | `mcpMessageTemplate` | string | Markdown template exposed as `{message}`. | #### 🔑 Reddit API credentials (recommended) Reddit aggressively blocks anonymous/datacenter traffic with `403` errors. For reliable results, use the official API: 1. Go to **https://www.reddit.com/prefs/apps** → **Create another app**. 2. Choose **script** (or **web app**), give it a name, set the redirect URI to `http://localhost` (unused for app-only access). 3. Copy the **client ID** (under the app name) and **secret** into `redditClientId` / `redditClientSecret`. The Actor uses these for userless (app-only) read access — no Reddit login or user token needed. Without credentials it falls back to the public endpoints, which may be blocked. #### Placeholders available in arguments / template `{title}` · `{author}` · `{subreddit}` · `{score}` · `{num_comments}` · `{permalink}` · `{url}` · `{selftext}` · `{created}` · `{flair}` · `{id}` · `{message}` #### Example: deliver each post to Slack ```json { "mode": "subreddit", "subreddit": "MachineLearning", "sort": "top", "time": "week", "limit": 10, "mcpConnector": "", "deliveryMode": "perPost", "mcpTool": "send_message", "mcpArguments": { "channel": "#reddit", "text": "{message}" }, "mcpMessageTemplate": "*{title}* by u/{author} — {score} upvotes\n{permalink}" } ```` ### 📦 Example Output (dataset row) ```json { "id": "1abc234", "title": "What are your favorite lesser-known stdlib modules?", "author": "example_user", "subreddit": "python", "score": 1543, "upvote_ratio": 0.97, "num_comments": 212, "permalink": "https://www.reddit.com/r/Python/comments/1abc234/...", "url": "https://www.reddit.com/r/Python/comments/1abc234/...", "flair": "Discussion", "over_18": false, "created": "2026-06-24T12:30:00+00:00", "scrapeMode": "subreddit" } ``` ### 💵 Pricing Pay-per-event: a small fee per **scraped post** and per **successful connector delivery**. Failed Reddit requests are not charged. *** ### 🔗 Integrations Deliver Reddit data into any MCP connector you've authorized in Apify: - **Notion** — create pages/database rows per post - **Slack / Discord** — post messages to a channel - **Linear / Jira** — open issues from relevant posts - **Airtable / Google Sheets** — append structured rows - **GitHub** — open issues or discussions - …or any other MCP-compatible connector You can also consume the dataset directly via the Apify API, or wire it into n8n, Zapier, and Make. *** ### 🆘 Support For issues, questions, or feature requests: **Email**: bhavin.shah@techforceglobal.com #### Made with ❤️ for the Data Extraction community #### [📅 Book a 15-min consultation](https://calendly.com/techforce-infotech-pvt-ltd/intro-meeting) #### 🌐 Website: https://techforceglobal.com/apify-actors/ # Actor input Schema ## `mode` (type: `string`): What to scrape: 'search' (query Reddit), 'subreddit' (list a subreddit's posts), or 'post' (one post + its comments). ## `searchQuery` (type: `string`): Search terms. Used in 'search' mode. ## `searchScopeSubreddit` (type: `string`): Optional subreddit to scope the search to (without 'r/'). Empty = search all of Reddit. Used in 'search' mode. ## `subreddit` (type: `string`): Subreddit name without 'r/' (e.g. 'python'). Used in 'subreddit' mode. ## `postUrl` (type: `string`): A Reddit post URL/permalink or its id (e.g. 'abc123'). Used in 'post' mode. ## `sort` (type: `string`): Sort order. Search: relevance/hot/top/new/comments. Subreddit: hot/new/top/rising/controversial. Invalid values fall back to a sensible default. ## `time` (type: `string`): Time window for top/controversial/relevance sorts. ## `limit` (type: `integer`): Maximum posts to scrape in search/subreddit mode (1-100). ## `maxComments` (type: `integer`): Maximum comments to include in 'post' mode (0-500). ## `proxyConfiguration` (type: `object`): Apify Proxy used for every Reddit request. RESIDENTIAL is strongly recommended — Reddit blocks datacenter IPs. ## `redditClientId` (type: `string`): Recommended for reliability. Client ID of a Reddit app — create one at https://www.reddit.com/prefs/apps (choose 'script' or 'web app'). Using the official API avoids Reddit's anti-bot 403 blocks. Leave empty to use the public endpoints (less reliable). ## `redditClientSecret` (type: `string`): Secret of the Reddit app above. Required when a client ID is provided. ## `mcpConnector` (type: `string`): Pick a connector to deliver results to — Notion, Slack, Linear, Airtable, Jira, GitHub, or any MCP-compatible connector you have authorized. Leave empty to only store results in the dataset. ## `deliveryMode` (type: `string`): How to deliver to the connector: 'perPost' (one call per scraped post), 'summary' (one call with all posts combined), or 'none' (store only). ## `mcpTool` (type: `string`): Name of the tool to call on the connector (e.g. 'create\_page' for Notion, 'send\_message' for Slack). If unsure, run once with delivery on — the log lists the connector's available tools. ## `mcpArguments` (type: `object`): Arguments passed to the connector tool. String values support {placeholders} from each post: {title}, {author}, {subreddit}, {score}, {num\_comments}, {permalink}, {url}, {selftext}, {created}, {flair}, {id}, and {message} (the rendered template below). Example for Slack: {"channel": "#reddit", "text": "{message}"}. ## `mcpMessageTemplate` (type: `string`): Optional Markdown template rendered per post and exposed as the {message} placeholder in the tool arguments. Example: '*{title}* by u/{author} in r/{subreddit} ({score} upvotes)\n{permalink}'. ## Actor input object example ```json { "mode": "search", "searchQuery": "", "searchScopeSubreddit": "", "subreddit": "", "postUrl": "", "sort": "hot", "time": "all", "limit": 25, "maxComments": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" }, "redditClientId": "", "deliveryMode": "perPost", "mcpTool": "", "mcpArguments": {}, "mcpMessageTemplate": "" } ``` # Actor output Schema ## `posts` (type: `string`): One row per scraped Reddit post. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("techforce.global/reddit-posts-mcp-server").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", } } # Run the Actor and wait for it to finish run = client.actor("techforce.global/reddit-posts-mcp-server").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call techforce.global/reddit-posts-mcp-server --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=techforce.global/reddit-posts-mcp-server", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Reddit MCP Server", "description": "Model Context Protocol (MCP) server for Reddit. Search posts, read subreddit listings, fetch posts with comments, profile users, and discover trending communities — straight from your AI agent.", "version": "0.2", "x-build-id": "i87FcdGuaj65GLl0h" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/techforce.global~reddit-posts-mcp-server/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-techforce.global-reddit-posts-mcp-server", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/techforce.global~reddit-posts-mcp-server/runs": { "post": { "operationId": "runs-sync-techforce.global-reddit-posts-mcp-server", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/techforce.global~reddit-posts-mcp-server/run-sync": { "post": { "operationId": "run-sync-techforce.global-reddit-posts-mcp-server", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Scrape mode", "enum": [ "search", "subreddit", "post" ], "type": "string", "description": "What to scrape: 'search' (query Reddit), 'subreddit' (list a subreddit's posts), or 'post' (one post + its comments).", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Search terms. Used in 'search' mode.", "default": "" }, "searchScopeSubreddit": { "title": "Restrict search to subreddit", "type": "string", "description": "Optional subreddit to scope the search to (without 'r/'). Empty = search all of Reddit. Used in 'search' mode.", "default": "" }, "subreddit": { "title": "Subreddit", "type": "string", "description": "Subreddit name without 'r/' (e.g. 'python'). Used in 'subreddit' mode.", "default": "" }, "postUrl": { "title": "Post URL or ID", "type": "string", "description": "A Reddit post URL/permalink or its id (e.g. 'abc123'). Used in 'post' mode.", "default": "" }, "sort": { "title": "Sort", "enum": [ "relevance", "hot", "new", "top", "rising", "controversial", "comments" ], "type": "string", "description": "Sort order. Search: relevance/hot/top/new/comments. Subreddit: hot/new/top/rising/controversial. Invalid values fall back to a sensible default.", "default": "hot" }, "time": { "title": "Time range", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Time window for top/controversial/relevance sorts.", "default": "all" }, "limit": { "title": "Result limit", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum posts to scrape in search/subreddit mode (1-100).", "default": 25 }, "maxComments": { "title": "Max comments", "minimum": 0, "maximum": 500, "type": "integer", "description": "Maximum comments to include in 'post' mode (0-500).", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy used for every Reddit request. RESIDENTIAL is strongly recommended — Reddit blocks datacenter IPs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "redditClientId": { "title": "Reddit API client ID", "type": "string", "description": "Recommended for reliability. Client ID of a Reddit app — create one at https://www.reddit.com/prefs/apps (choose 'script' or 'web app'). Using the official API avoids Reddit's anti-bot 403 blocks. Leave empty to use the public endpoints (less reliable).", "default": "" }, "redditClientSecret": { "title": "Reddit API client secret", "type": "string", "description": "Secret of the Reddit app above. Required when a client ID is provided." }, "mcpConnector": { "title": "MCP connector (delivery target)", "type": "string", "description": "Pick a connector to deliver results to — Notion, Slack, Linear, Airtable, Jira, GitHub, or any MCP-compatible connector you have authorized. Leave empty to only store results in the dataset." }, "deliveryMode": { "title": "Delivery mode", "enum": [ "perPost", "summary", "none" ], "type": "string", "description": "How to deliver to the connector: 'perPost' (one call per scraped post), 'summary' (one call with all posts combined), or 'none' (store only).", "default": "perPost" }, "mcpTool": { "title": "Connector tool name", "type": "string", "description": "Name of the tool to call on the connector (e.g. 'create_page' for Notion, 'send_message' for Slack). If unsure, run once with delivery on — the log lists the connector's available tools.", "default": "" }, "mcpArguments": { "title": "Connector tool arguments", "type": "object", "description": "Arguments passed to the connector tool. String values support {placeholders} from each post: {title}, {author}, {subreddit}, {score}, {num_comments}, {permalink}, {url}, {selftext}, {created}, {flair}, {id}, and {message} (the rendered template below). Example for Slack: {\"channel\": \"#reddit\", \"text\": \"{message}\"}.", "default": {} }, "mcpMessageTemplate": { "title": "Message template", "type": "string", "description": "Optional Markdown template rendered per post and exposed as the {message} placeholder in the tool arguments. Example: '*{title}* by u/{author} in r/{subreddit} ({score} upvotes)\\n{permalink}'.", "default": "" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```