# Reddit — how to use (mcp.ai)

Reddit is a social news platform with user-driven communities (subreddits), offering content sharing, discussions, and viral marketing opportunities for brands

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_reddit?ms=1781541780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `reddit_create_reddit_post`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/reddit`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/reddit/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/reddit/create/reddit/post` — Creates a new text or link post on a specified, existing reddit subreddit, optionally applying a flair.
  - body: { url?: string, kind: string, text?: string, title: string, flair_id: string, subreddit: string }
- `POST https://api.mcp.ai/api/reddit/delete/reddit/comment` — Deletes a reddit comment, identified by its fullname id, if it was authored by the authenticated user.
  - body: { id: string }
- `POST https://api.mcp.ai/api/reddit/delete/reddit/post` — Permanently deletes a reddit post by its id, provided the authenticated user has deletion permissions for that post.
  - body: { id: string }
- `POST https://api.mcp.ai/api/reddit/edit/reddit/comment/or/post` — Edits the body text of the authenticated user's own existing comment or self-post on reddit; cannot edit link posts or titles.
  - body: { text: string, thing_id: string }
- `POST https://api.mcp.ai/api/reddit/get/user/flair` — Fetches the list of available link flairs (i.e., post flairs, not user flairs) for a given subreddit.
  - body: { subreddit: string }
- `POST https://api.mcp.ai/api/reddit/post/reddit/comment` — Posts a comment on reddit, replying to an existing and accessible submission (post) or another comment.
  - body: { text: string, thing_id: string }
- `POST https://api.mcp.ai/api/reddit/retrieve/post/comments` — Retrieves all comments for a reddit post given its article id (which must be for an existing, public post); nested replies within comments are returned as raw dictionaries requiring parsing.
  - body: { article: string }
- `POST https://api.mcp.ai/api/reddit/retrieve/reddit/post` — Retrieves the current hot posts from a specified, publicly accessible subreddit.
  - body: { size?: integer, subreddit: string }
- `POST https://api.mcp.ai/api/reddit/retrieve/specific/comment` — Retrieves detailed information for a specific reddit comment or post using its fullname.
  - body: { id: string }
- `POST https://api.mcp.ai/api/reddit/search/across/subreddits` — Searches reddit for content (e.g., posts, comments) using a query, with results typically confined to subreddits unless `restrict sr` is set to false.
  - body: { sort?: string, limit?: integer, restrict_sr?: boolean, search_query: string }

## More
- Page: https://mcp.ai/reddit
- Agent spec (llms.txt): https://mcp.ai/reddit/llms.txt
- Postman collection: https://mcp.ai/reddit/postman.json