Pa1m Reddit

Official13 tools

by retampweb

Pay-per-call Reddit agent: post reading, voting, commenting, DM and OAuth flows. x402, USDC on Base.

io.github.retampweb/pa1m-reddit (MCP Server)

The MCP server io.github.retampweb/pa1m-reddit is described as a pay-per-call Reddit agent. Its capabilities include posting (reading/post actions), voting, commenting, and DM handling, along with OAuth flows. The description also references x402 and USDC on Base.

🛠️ Key Features

Post reading and posting
Voting
Commenting
DM and OAuth flows
Uses x402 and USDC on Base
13 tools available

🚀 Use Cases

Automate Reddit interactions via an MCP tool interface
Perform voting and commenting as part of paid calls
Support authenticated access via OAuth
Send or manage Reddit DMs

⚡ Developer Benefits

Provides a toolset for Reddit agent actions (13 tools)
Includes OAuth-related flow support for accessing Reddit

⚠️ Limitations

Details beyond posting, voting, commenting, DMs, and OAuth are not provided

Captured live from the server via tools/list.

agent_info__well_known_agent_json_get

Agent Info ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "agent_info__well_known_agent_json_getArguments"
}

health_health_get

Health ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "health_health_getArguments"
}

llms_txt_llms_txt_get

Llms Txt ### Responses: **200**: Successful Response (Success Response) Content-Type: text/plain **Example Response:** ```json "string" ```

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "llms_txt_llms_txt_getArguments"
}

get_posts_posts_get

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

Parameters5

subreddit	string	required	Subreddit name without r/ prefix
sort	string	optional	hot \| new \| top \| rising \| controversial \| best
t	string	optional	Time window for top/controversial: hour \| day \| week \| month \| year \| all
limit	integer	optional
after	string	optional	Pagination cursor (t3_xxx)

Raw schema

{
  "type": "object",
  "properties": {
    "subreddit": {
      "type": "string",
      "description": "Subreddit name without r/ prefix",
      "title": "subreddit"
    },
    "sort": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "hot | new | top | rising | controversial | best",
      "default": "hot",
      "title": "sort",
      "type": "string"
    },
    "t": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Time window for top/controversial: hour | day | week | month | year | all",
      "title": "t",
      "type": "string"
    },
    "limit": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 100,
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "default": 25,
      "title": "limit",
      "type": "integer"
    },
    "after": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Pagination cursor (t3_xxx)",
      "title": "after",
      "type": "string"
    }
  },
  "required": [
    "subreddit"
  ],
  "title": "get_posts_posts_getArguments"
}

search_posts_search_get

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

Parameters7

q	string	required	Search query
subreddit	string	optional	Restrict to a subreddit (without r/ prefix)
sort	string	optional	relevance \| new \| hot \| top \| comments
t	string	optional	hour \| day \| week \| month \| year \| all
nsfw	boolean	optional	Include NSFW content
limit	integer	optional
after	string	optional	Pagination cursor

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search query",
      "title": "q"
    },
    "subreddit": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Restrict to a subreddit (without r/ prefix)",
      "title": "subreddit",
      "type": "string"
    },
    "sort": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "relevance | new | hot | top | comments",
      "default": "relevance",
      "title": "sort",
      "type": "string"
    },
    "t": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "hour | day | week | month | year | all",
      "title": "t",
      "type": "string"
    },
    "nsfw": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Include NSFW content",
      "default": false,
      "title": "nsfw",
      "type": "boolean"
    },
    "limit": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 100,
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "default": 25,
      "title": "limit",
      "type": "integer"
    },
    "after": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Pagination cursor",
      "title": "after",
      "type": "string"
    }
  },
  "required": [
    "q"
  ],
  "title": "search_posts_search_getArguments"
}

get_comments_by_permalink_comments_get

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

Parameters1

permalink

string

required

Reddit post permalink, e.g. /r/python/comments/abc/title/

Raw schema

{
  "type": "object",
  "properties": {
    "permalink": {
      "type": "string",
      "description": "Reddit post permalink, e.g. /r/python/comments/abc/title/",
      "title": "permalink"
    }
  },
  "required": [
    "permalink"
  ],
  "title": "get_comments_by_permalink_comments_getArguments"
}

get_comments_by_id_comments__post_id__get

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

Parameters1

post_id

string

required

Reddit post ID like 1sgjld3

Raw schema

{
  "type": "object",
  "properties": {
    "post_id": {
      "type": "string",
      "description": "Reddit post ID like 1sgjld3",
      "title": "post_id"
    }
  },
  "required": [
    "post_id"
  ],
  "title": "get_comments_by_id_comments__post_id__getArguments"
}

get_user_userusernameget

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

Parameters1

username

string

required

Reddit username without u/ prefix

Raw schema

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "Reddit username without u/ prefix",
      "title": "username"
    }
  },
  "required": [
    "username"
  ],
  "title": "get_user_user__username__getArguments"
}

get_user_comments_userusernamecomments_get

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

Parameters4

username	string	required	Reddit username without u/ prefix
sort	string	optional	new \| top \| controversial
limit	integer	optional
after	string	optional	Pagination cursor

Raw schema

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "Reddit username without u/ prefix",
      "title": "username"
    },
    "sort": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "new | top | controversial",
      "default": "new",
      "title": "sort",
      "type": "string"
    },
    "limit": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 100,
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "default": 25,
      "title": "limit",
      "type": "integer"
    },
    "after": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Pagination cursor",
      "title": "after",
      "type": "string"
    }
  },
  "required": [
    "username"
  ],
  "title": "get_user_comments_user__username__comments_getArguments"
}

login_login_post

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

Parameters3

username	string	required
password	string	required
totp_secret	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "title": "username"
    },
    "password": {
      "type": "string",
      "title": "password"
    },
    "totp_secret": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "totp_secret",
      "type": "string"
    }
  },
  "required": [
    "username",
    "password"
  ],
  "title": "login_login_postArguments"
}

post_comment_comment_post

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

Parameters6

post_url	string	required
text	string	required
reddit_session	string	required
loid	string	required
csrf_token	string	optional
token_v2	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "post_url": {
      "type": "string",
      "title": "post_url"
    },
    "text": {
      "type": "string",
      "title": "text"
    },
    "reddit_session": {
      "type": "string",
      "title": "reddit_session"
    },
    "loid": {
      "type": "string",
      "title": "loid"
    },
    "csrf_token": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "csrf_token",
      "type": "string"
    },
    "token_v2": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "token_v2",
      "type": "string"
    }
  },
  "required": [
    "post_url",
    "text",
    "reddit_session",
    "loid"
  ],
  "title": "post_comment_comment_postArguments"
}

vote_vote_post

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

Parameters5

thing_id	string	required
direction	string	required
reddit_session	string	required
loid	string	required
csrf_token	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "thing_id": {
      "type": "string",
      "title": "thing_id"
    },
    "direction": {
      "type": "string",
      "title": "direction"
    },
    "reddit_session": {
      "type": "string",
      "title": "reddit_session"
    },
    "loid": {
      "type": "string",
      "title": "loid"
    },
    "csrf_token": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "csrf_token",
      "type": "string"
    }
  },
  "required": [
    "thing_id",
    "direction",
    "reddit_session",
    "loid"
  ],
  "title": "vote_vote_postArguments"
}

send_dm_dm_post

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

Parameters6

to_username	string	optional
to_user_t2	string	optional
message	string	required
reddit_session	string	required
loid	string	required
csrf_token	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "to_username": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "to_username",
      "type": "string"
    },
    "to_user_t2": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "to_user_t2",
      "type": "string"
    },
    "message": {
      "type": "string",
      "title": "message"
    },
    "reddit_session": {
      "type": "string",
      "title": "reddit_session"
    },
    "loid": {
      "type": "string",
      "title": "loid"
    },
    "csrf_token": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "csrf_token",
      "type": "string"
    }
  },
  "required": [
    "message",
    "reddit_session",
    "loid"
  ],
  "title": "send_dm_dm_postArguments"
}

Install

Tools (13)

agent_info__well_known_agent_json_gethealth_health_getllms_txt_llms_txt_getget_posts_posts_getsearch_posts_search_getget_comments_by_permalink_comments_getget_comments_by_id_comments__post_id__getget_user_user__username__get

Remote endpoint

SSE

Hosted server - connect over the network, no local install.

url

https://reddit.hypa1m.xyz/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "pa1m-reddit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://reddit.hypa1m.xyz/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.retampweb/pa1m-reddit (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

agent_info__well_known_agent_json_get

health_health_get

llms_txt_llms_txt_get

get_posts_posts_get

search_posts_search_get

get_comments_by_permalink_comments_get

get_comments_by_id_comments__post_id__get

get_user_user__username__get

get_user_comments_user__username__comments_get

login_login_post

post_comment_comment_post

vote_vote_post

send_dm_dm_post

Install

Remote endpoint

Related servers

get_user_userusernameget

get_user_comments_userusernamecomments_get