All integrations
Reddit
Read and submit posts and comments across subreddits.
Social
How an agent reaches it
MCPREST APICLI
How you authenticate
OAuth
Connection details
- Base URL
- https://oauth.reddit.com
- Pagination
- cursor
- Rate limit
- 60 requests/minute per OAuth client. Read X-Ratelimit-Remaining.
Common endpoints
| who am I | GET /api/v1/me |
| read a subreddit | GET /r/{subreddit}/hot?limit=25 |
| search | GET /r/{subreddit}/search?q={q}&restrict_sr=1 |
| submit a post | POST /api/submit |
| comment | POST /api/comment |
Worth knowing
- A descriptive User-Agent is MANDATORY and Reddit 429s generic ones aggressively. Use something like `idapt/1.0 (by /u/yourname)`.
- Authenticated calls go to oauth.reddit.com, never www.reddit.com.
- Responses are Thing-wrapped: the real payload is under data.children[].data.
- Reddit's terms restrict commercial use and model training on its content. Read them before building on this.