mcp server
Pa1m Reddit
Pay-per-call Reddit agent: post reading, voting, commenting, DM and OAuth flows. x402, USDC on Base.
Description as published by the maintainer. Source
- version 1.0.0
- active
active — Registry entry last updated 2026-07-27.
What this server can do
10 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.
get_comments_by_id(post_id)- Post Comments by Post ID — $0.01 Fetch the full comment tree for a Reddit post using its short alphanumeric post ID. Same response as the permalink endpoint — use this when you have the ID, not the full URL. Post IDs can be extracted from Reddit URLs: reddit.com/r/x/comments/{post_id}/... Example: GET /comments/1abc123 ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json Required: post_id.
get_comments_by_permalink(permalink)- Post Comments by Permalink — $0.01 Fetch the full comment tree for a Reddit post using its permalink URL. Returns top-level comments with nested replies, upvote counts, and author metadata. Use this when you have the full Reddit URL. Permalink format: /r/{subreddit}/comments/{post_id}/{title}/ Example: GET /comments?permalink=/r/python/comments/1abc123/my_post_title/ ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json Required: permalink.
get_posts(t, sort, after, limit, subreddit)- Subreddit Posts — $0.01 Fetch posts from any subreddit with sorting and pagination. No Reddit account needed. Sorting options: hot (trending now), new (most recent), top (most upvoted), rising (gaining momentum), controversial (most debated), best (Reddit's personalized ranking). Use t= parameter (hour/day/week/month/year/all) with sort=top or sort=controversial. Paginate by passing the 'after' cursor from the previous response. Up to 100 posts per call. Example: GET /posts?subreddit=MachineLearning&sort=top&t=week&limit=50 ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json Required: subreddit.
get_user(username)- User Profile — $0.01 Fetch a Reddit user's public profile. Returns link karma, comment karma, account age, gold/mod/employee status flags, verified email flag, icon URL, and profile description. Example: GET /user/spez ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json Required: username.
get_user_comments(sort, after, limit, username)- User Comment History — $0.01 Fetch a Reddit user's recent comments. Each item includes subreddit, upvote score, parent post title, comment body, and creation timestamp. Sort by new (default), top, or controversial. Paginate with the 'after' cursor. Example: GET /user/spez/comments?sort=top&limit=10 ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json Required: username.
login(password, username, totp_secret)- Reddit Login — $0.05 Authenticate a Reddit account and receive session cookies needed for write operations (comment, vote, DM). Cookies are valid until revoked by Reddit. For accounts with 2FA, pass totp_secret to generate the TOTP code automatically. Body: {"username": "...", "password": "...", "totp_secret": "..." (optional)} ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json Required: username, password.
post_comment(loid, text, post_url, token_v2, csrf_token, reddit_session)- Post Comment — $0.05 Submit a top-level comment on a Reddit post. Requires session cookies from POST /login (reddit_session + loid fields). Body: {"post_url": "https://reddit.com/r/...", "text": "...", "reddit_session": "...", "loid": "..."} ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json Required: post_url, text, reddit_session, loid.
search_posts(q, t, nsfw, sort, after, limit, subreddit)- Search Reddit Posts — $0.01 Search Reddit posts globally or restrict to a specific subreddit. Mirrors the Posts tab on reddit.com/search. Sorting: relevance (default — highest upvoted may outrank closest match on broad queries), new (strict chronological), hot, top, comments. Tip: use sort=new with t=week for recent topical results; sort=relevance for best match. Set nsfw=true to include adult content. Paginate with 'after' cursor. Example: GET /search?q=Claude+API&sort=new&t=month&limit=25 ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json Required: q.
send_dm(loid, message, csrf_token, to_user_t2, to_username, reddit_session)- Send Direct Message — $0.10 Send a private message to a Reddit user. Pass to_username (e.g. 'spez') or to_user_t2 (Reddit internal ID like t2_xxx). Requires session cookies from POST /login. Body: {"to_username": "spez", "message": "Hello!", "reddit_session": "...", "loid": "..."} ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json Required: message, reddit_session, loid.
vote(loid, thing_id, direction, csrf_token, reddit_session)- Vote — $0.02 Upvote or downvote a Reddit post or comment. thing_id format: t3_xxx for posts, t1_xxx for comments. direction: up | down | none (none removes your vote). Requires session cookies from POST /login. Body: {"thing_id": "t3_abc123", "direction": "up", "reddit_session": "...", "loid": "..."} ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json Required: thing_id, direction, reddit_session, loid.
Last successful function declaration observed on . Source: https://reddit.hypa1m.xyz/mcp. We list what the server declared; we do not call any of these functions.
Endpoint status observed on . Source: https://reddit.hypa1m.xyz/mcp.
Signals
These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.
| Signal | Value | What it measures | Window | Observed | Source |
|---|---|---|---|---|---|
| Latest published version | 1.0.0 | Latest version string the maintainer published to the registry. | as of fetch | Model Context Protocol | |
| Registry record last updated | 2026-07-27 | When the registry record was last updated by its maintainer. | point in time | Model Context Protocol | |
| First listed in the MCP Registry | 2026-07-27 | Date this server was first published to the official MCP Registry. Not a usage or quality measure. | point in time | Model Context Protocol | |
| mcp tools declared | 10 tools | Number of functions the server itself declared when asked to list them. This is what the server offers an agent, not a measure of how well any of them work. | as of probe | reddit.hypa1m.xyz | |
| mcp endpoint status | ok | The server listed 10 functions when asked. | as of probe | reddit.hypa1m.xyz |
Where to get it
This record as data
Every field on this page, with its source and observation date, is in the catalog JSON. Fetch the whole kind at once instead of parsing this HTML.
GET /api/v1/entries/mcp_server.json