Connect Reddit to ORQO so that agents can search, read, and post content on Reddit through MCP tools.
| Category | Social |
| Capabilities | MCP tools only (no send/receive channel) |
| Adapter path | /reddit |
| Auth method | OAuth 2.0 |
Reddit is an MCP-only integration. It provides tools for agents to interact with Reddit programmatically, but does not support inbound/outbound messaging through Doorkeeper or channels.
Prerequisites
- A Reddit account
- A Reddit app registered at reddit.com/prefs/apps (type: "script" or "web app")
- Access to the ORQO Settings area
Setup
1. Create a Reddit App
- Go to reddit.com/prefs/apps and click Create App (or Create Another App).
- Choose the app type (script for personal use, web app for OAuth flows).
- Set the redirect URI to the OAuth Callback URL shown on the app's detail card in ORQO.
- Note the client ID (shown under the app name) and the client secret.
2. Install the Reddit App in ORQO
- Navigate to Settings > Apps in ORQO.
- Find Reddit in the app catalog and click Install.
- The app is created with the correct adapter URL and capabilities.
3. Add Credentials
After installation, the credentials checklist shows what's required:
| Credential | Type | Description |
|---|---|---|
| REDDIT_OAUTH2 | oauth2 | OAuth 2.0 credentials (client ID, client secret, tokens) |
Create the credential in Settings > Credentials, then assign it to the Reddit App. Use the OAuth flow to authorize ORQO with Reddit.
4. Authorize via OAuth
- Click the Authorize button on the Reddit app card in ORQO.
- You are redirected to Reddit's consent screen.
- Approve the requested permissions.
- ORQO stores the tokens and refreshes them automatically.
5. Verify the Connection
Click Verify on the Reddit app card in ORQO. This tests the connection to the adapter and discovers the available MCP tools.
Available Tools
The Reddit adapter exposes MCP tools that agents can use in workflows:
| Tool | Description |
|---|---|
search_reddit | Search Reddit for posts matching a query |
read_reddit_post | Read a specific Reddit post and its comments |
list_reddit_subreddit_posts | List recent posts from a subreddit |
get_reddit_subreddit | Get information about a subreddit |
create_reddit_post | Create a new post in a subreddit |
create_reddit_comment | Add a comment to a Reddit post |
These tools are discovered automatically when the App is verified and can be assigned to agents via Skills.
Platform-Specific Behavior
- OAuth 2.0 with HTTP Basic auth — Reddit's token exchange requires the client ID and secret to be sent as HTTP Basic authentication, not in the request body. The adapter handles this automatically.
- Rate limiting — Reddit enforces API rate limits. The adapter respects these limits and returns appropriate errors if they are exceeded.
- No channel capabilities — Unlike Slack, WhatsApp, or Telegram, Reddit does not support send/receive channels. It is a tool-only integration for programmatic interaction with Reddit content.
What's Next
- Apps & Channels for the full architecture
- Create a Skill to bundle Reddit tools for agents
- Set Up Assignments to give agents access to Reddit tools in workflows