mcpField
F
forumport

forumport

Local
github.com/CloudCorpRecordsSocial Media0Updated 2w ago
Repository

About forumport

forumport exposes a subset of Reddit’s API for browsing subreddits, posts, comments, and users, as well as submitting posts and comments. It is for MCP clients and CLI use, and authenticates requests with a supplied Reddit access token rather than an OAuth app flow.

Key features

  1. 01Browse subreddit hot, new, and top posts
  2. 02Search posts and subreddits
  3. 03Retrieve posts, comments, and user data
  4. 04Submit posts and create comments
  5. 05Bearer-token API authentication

Use cases

  1. 01Retrieving subreddit posts for an agent
  2. 02Looking up Reddit posts and comments
  3. 03Submitting a post or comment through a tool

MCP support

Exposes 12 Reddit tools to MCP clients for subreddit, post, comment, and user operations. It runs as a stdio MCP server and requires `REDDIT_ACCESS_TOKEN` for API requests.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "cloudcorprecords-forumport": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/forumport"
      ]
    }
  }
}
Run commandnpx -y @reneturcios/forumport

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@reneturcios/forumport0.1.0
ocighcr.io/cloudcorprecords/forumport:0.1.0

Tools

12

Saved tool list · updated 1w ago

ParameterTypeRequiredDescription
limitnumberNoMaximum number of posts to return.
subredditstringYesSubreddit name, without the r/ prefix.

Details

From the project README

forumport

Reddit as MCP tools, talking to the Reddit API. forumport is a clean-room rebuild of the core surface of the Reddit MCP server, under a new name: fresh code, no copied branding.

Auth model — TOKEN-ENV ONLY: tools take REDDIT_ACCESS_TOKEN directly and send it as Authorization: Bearer against https://oauth.reddit.com. The OAuth app flow (REDDIT_CLIENT_ID/REDDIT_CLIENT_SECRET + script/password grant + refresh) is NOT reproduced.

Tools (core subset, 12)

get_subreddit_hot, get_subreddit_new, get_subreddit_top, search_posts, get_post, get_post_comments, get_subreddit_about, search_subreddits, get_user_profile, get_user_posts, submit_post, create_comment.

Not in this subset: OAuth app authorization/token/refresh flow, private messages and inbox, moderation tools, wiki, flair management, awards/gold, multireddits/collections, user settings/preferences, subreddit settings/admin, live threads, media upload, voting and save/hide/report writes beyond submit/comment, account creation.

Setup

Create a Reddit access token and set it:

export REDDIT_ACCESS_TOKEN=...

Optionally override the API base with REDDIT_API_BASE_URL (default https://oauth.reddit.com) and the User-Agent with REDDIT_USER_AGENT (default forumport/0.1.0 (MCP rebuild)). Every request carries the token as a Bearer header and a User-Agent header. Without the token, every tool call fails with an error naming the missing variable.

CLI

npx @reneturcios/forumport get_subreddit_hot '{"subreddit":"node","limit":10}'
npx @reneturcios/forumport mcp        # stdio MCP server

Each tool name is a subcommand taking one JSON object argument.

MCP client config

{
  "mcpServers": {
    "forumport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/forumport", "mcp"],
      "env": { "REDDIT_ACCESS_TOKEN": "..." }
    }
  }
}

Docker

docker run -i -e REDDIT_ACCESS_TOKEN ghcr.io/cloudcorprecords/forumport

Development

npm install
npm run build
npm test

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.