Prerequisites
- A Reddit account and a Reddit app (script or web app type)
- OAuth client ID, client secret, and refresh token for the posting account
- Moderator or posting permissions on target subreddits
- A descriptive User-Agent string (Reddit requires unique app identification)
- project_contributor access in AgentRuntime
Connect in AgentRuntime
1
Create a Reddit application
At reddit.com/prefs/apps, create an app and note the client ID (under the app name) and client secret.
2
Obtain a refresh token
Complete the OAuth authorization code flow for the Reddit account that will post or comment. Store the refresh token securely.
3
Create a connection
Go to Connections and click New custom connection to create a connection with
ClientID, ClientSecret, RefreshToken, and UserAgent (e.g. agentruntime:workflow:v1.0 (by /u/yourname)).4
Add reddit MCP instance
Go to MCP, click Add instance for reddit, wire your connection on Instance config, set the profile active, and save.
5
Test read access
Run mcp_call →
retrieve_reddit_post on a public post ID before enabling write tools.Always use human_task approval before
create_reddit_post or create_reddit_comment in production subreddits. Respect subreddit rules and Reddit API rate limits.What you can build
- Community monitoring — Scheduled
fetch_post_comments→ LLM sentiment summary → alert on negative trends. - Approved publishing — Draft post in workflow → human_task →
create_reddit_postas self or link post. - Support triage —
get_reddit_post_detailson mentions → create ClickUp or GitLab ticket from thread context. - Thread cleanup —
edit_reddit_post_or_commentordelete_reddit_post_or_commentafter moderation review.
Tools
Example
Post a link after human approval:Configuration
Troubleshooting
Related
- Integrations quickstart
- Human tasks — approval before posting
- Connector catalog
- Troubleshooting