Which integrations are available for this server?

Allows publishing text posts to Reddit subreddits, including searching communities, checking subreddit rules, previewing posts, and submitting with dry-run and security features like allowlist and rate limiting.

How do I use mcp-reddit-publisher?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-reddit-publisher search subreddits for SaaS and startups" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-reddit-publisher

by uptrixbr

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

mcp-reddit-publisher

Servidor MCP para publicar no Reddit com segurança, feito para ser instalado do jeito mais simples possível em Claude, Codex, OpenCode e qualquer cliente MCP via stdio.

Repo: https://github.com/uptrixbr/mcp-reddit-publisher Pacote npm: mcp-reddit-publisher

Instalação rápida

Você NÃO precisa clonar o projeto nem rodar build manual.

Use direto via npm/npx:

npx -y mcp-reddit-publisher --help

Para gerar uma configuração pronta para o seu cliente:

npx -y mcp-reddit-publisher setup claude \
  --client-id "SEU_REDDIT_CLIENT_ID" \
  --client-secret "SEU_REDDIT_CLIENT_SECRET" \
  --refresh-token "SEU_REDDIT_REFRESH_TOKEN" \
  --user-agent "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO" \
  --allowed "SideProject,saas,startups" \
  --dry-run true

Troque claude por codex ou opencode:

npx -y mcp-reddit-publisher setup codex ...
npx -y mcp-reddit-publisher setup opencode ...

O comando imprime o bloco de configuração MCP já pronto para copiar e colar.

Fallback sem npm registry, direto do GitHub:

npx -y github:uptrixbr/mcp-reddit-publisher --help

Related MCP server: mcp-reddit-publisher

Credenciais Reddit

Você precisa criar um app Reddit uma vez:

Acesse https://www.reddit.com/prefs/apps
Clique em create another app.
Escolha o tipo script para uso pessoal/local.
Copie:
- client_id
- client_secret
Configure um user agent descritivo, exemplo:

mcp-reddit-publisher/0.1.0 by u/seu_usuario

Autenticação recomendada:

REDDIT_REFRESH_TOKEN

Alternativa para app do tipo script:

REDDIT_USERNAME + REDDIT_PASSWORD

Claude Desktop / Claude Code

Gere o config:

npx -y mcp-reddit-publisher setup claude \
  --client-id "..." \
  --client-secret "..." \
  --refresh-token "..." \
  --user-agent "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO" \
  --allowed "SideProject,saas" \
  --dry-run true

Saída esperada:

{
  "mcpServers": {
    "reddit-publisher": {
      "command": "npx",
      "args": ["-y", "mcp-reddit-publisher"],
      "env": {
        "REDDIT_CLIENT_ID": "...",
        "REDDIT_CLIENT_SECRET": "...",
        "REDDIT_REFRESH_TOKEN": "...",
        "REDDIT_USER_AGENT": "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO",
        "REDDIT_DRY_RUN": "true"
      }
    }
  }
}

Cole no arquivo de configuração MCP do Claude e reinicie o Claude.

Codex

Gere o config:

npx -y mcp-reddit-publisher setup codex \
  --client-id "..." \
  --client-secret "..." \
  --refresh-token "..." \
  --user-agent "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO" \
  --dry-run true

Saída esperada em TOML:

[mcp_servers.reddit-publisher]
command = "npx"
args = ["-y", "mcp-reddit-publisher"]
env.REDDIT_CLIENT_ID = "..."
env.REDDIT_CLIENT_SECRET = "..."
env.REDDIT_REFRESH_TOKEN = "..."
env.REDDIT_USER_AGENT = "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO"
env.REDDIT_DRY_RUN = "true"

Adicione ao config.toml do Codex e reinicie o Codex.

OpenCode

Gere o config:

npx -y mcp-reddit-publisher setup opencode \
  --client-id "..." \
  --client-secret "..." \
  --refresh-token "..." \
  --user-agent "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO" \
  --dry-run true

Saída esperada:

{
  "mcp": {
    "reddit-publisher": {
      "type": "local",
      "command": "npx -y mcp-reddit-publisher",
      "enabled": true,
      "environment": {
        "REDDIT_CLIENT_ID": "...",
        "REDDIT_CLIENT_SECRET": "...",
        "REDDIT_REFRESH_TOKEN": "...",
        "REDDIT_USER_AGENT": "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO",
        "REDDIT_DRY_RUN": "true"
      }
    }
  }
}

Adicione ao arquivo de configuração do OpenCode e reinicie o OpenCode.

OpenAI Agents / outros clientes MCP

Use o servidor stdio:

{
  "command": "npx",
  "args": ["-y", "mcp-reddit-publisher"],
  "env": {
    "REDDIT_CLIENT_ID": "...",
    "REDDIT_CLIENT_SECRET": "...",
    "REDDIT_REFRESH_TOKEN": "...",
    "REDDIT_USER_AGENT": "mcp-reddit-publisher/0.1.0 by u/SEU_USUARIO",
    "REDDIT_DRY_RUN": "true"
  }
}

Ferramentas MCP disponíveis

health: valida a configuração sem expor secrets.
search_subreddits: busca comunidades por termo.
get_subreddit_rules: lê regras do subreddit e aponta riscos.
preview_text_post: valida e mostra o post sem publicar.
submit_text_post: publica o post, respeitando dry-run, allowlist, checagem de regras e rate limit.

Segurança por padrão

Por padrão, nada é publicado:

REDDIT_DRY_RUN=true

Recomendações:

REDDIT_ALLOWED_SUBREDDITS=SideProject,saas,startups
REDDIT_REQUIRE_RULE_CHECK=true
REDDIT_MIN_SECONDS_BETWEEN_POSTS=300

Só mude para publicação real depois de testar:

REDDIT_DRY_RUN=false

Exemplo de prompt depois de instalar

Use o reddit-publisher para buscar subreddits sobre SaaS, verificar as regras de r/SideProject e preparar um post pedindo feedback. Faça apenas preview, não publique.

Depois, se estiver tudo certo e REDDIT_DRY_RUN=false:

Publique em r/SideProject somente se as regras permitirem e me retorne o permalink.

Desenvolvimento local

git clone https://github.com/uptrixbr/mcp-reddit-publisher.git
cd mcp-reddit-publisher
npm install
npm run typecheck
npm test
npm run build
node scripts/smoke.mjs

Licença

Uso permitido para uso pessoal, avaliação, integrações e uso interno.

Não é permitido vender, redistribuir comercialmente, republicar como seu, remover créditos, fazer white-label ou oferecer como produto/SaaS/serviço próprio sem autorização por escrito.

Crédito obrigatório: MCP Reddit Publisher by Samuel Novaes / UptrixBR.

Veja LICENSE.

Available Tools

5 tools

get_subreddit_rulesGet subreddit rulesB

Fetches subreddit rules and flags obvious promotional-posting risks.

Inputs: subreddit (required).

healthHealth checkA

Shows current configuration status without revealing secrets.

Inputs: no named parameters.

preview_text_postPreview text postC

Validates and previews a Reddit text post without publishing.

Inputs: subreddit (required), title (required), body (required), sendReplies, +3 more.

search_subredditsSearch subredditsB

Searches Reddit communities by query to help find audience fit before posting.

Inputs: query (required), limit.

submit_text_postSubmit text postB

Publishes a Reddit text post. By default REDDIT_DRY_RUN=true prevents real publishing; set false only after testing.

Inputs: subreddit (required), title (required), body (required), sendReplies, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.4/5.0

Scored 2026-06-18 18:55 across 5 tools

Disambiguation5/5

Each tool has a clear, distinct purpose: fetching rules, checking health, previewing posts, searching subreddits, and submitting. No overlap.

Naming Consistency4/5

Most tools follow verb_noun snake_case (get_subreddit_rules, preview_text_post, etc.), but 'health' deviates as a single noun. Nearly consistent.

Tool Count5/5

Five tools cover the core publishing workflow: rules, health, preview, search, submit. Not excessive or insufficient.

Completeness4/5

Covers the main lifecycle: find subreddit, check rules, preview, submit. Minor gaps like post status or deletion are acceptable for a focused publisher.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

reddit-scraper
io.github.fashionmascherine-svg
Reddit MCP server: search posts, subreddit feeds, comments & user profiles as JSON. No API key.
Social Media Web Scraping
2
https://opportunity-biz--reddit-scraper.apify.actor/mcp
Reddit Subreddit Posts, Search & Comments API MCP Server
io.redditdataapi
Real-time Reddit posts, subreddit search, comments & mentions MCP. Local npx or hosted OAuth.
Social Media Search
1
https://mcp.redditdataapi.io/v1/mcp
PostHero
ai.posthero
PostHero MCP server — schedule and publish social media posts from any MCP-compatible AI tool
Social Media App Automation
1
https://mcp.posthero.ai/mcp
Reddit Ads MCP Server by AdKit
io.github.adkit
Reddit Ads MCP server: run Reddit campaigns, ad groups, ads and reports from AI.
1
https://mcp.adkit.so/reddit-ads

Related MCP Servers

reddit-mcp
Social Media Web Scraping
iris-alights
A
license
B
quality
D
maintenance
An MCP server that provides both read-only and authenticated access to Reddit content and interactions without requiring a developer API key. It enables users to browse posts, search subreddits, and perform write actions like commenting and voting by leveraging browser session cookies.
Updated 5 months ago (2026-06-02 05:00 UTC)
8
27 PyPI
3
-
mcp-reddit-publisher
Social Media Communication
osamuelnovaes
A
license
A
quality
D
maintenance
MCP server for publishing to Reddit with safety features like dry-run, allowlist, and rule checking.
Updated 5 months ago (2026-06-18 18:30 UTC)
5
MIT
reddit-mcp
Social Media Search
EmptyMind4
A
license
Not graded
quality
D
maintenance
MCP server for interacting with Reddit via OAuth, with tiered tools for reading, writing, and moderation actions.
Updated 3 months ago (2026-08-01 15:09 UTC)
MIT
reddit-mcp
Social Media Search
sunil-gumatimath
A
license
Not graded
quality
B
maintenance
A local, read-only Reddit MCP server that provides tools for searching posts, retrieving posts/comments, subreddit information, and user content via the official Reddit Data API with caching and privacy-focused features.
Updated 3 months ago (2026-08-02 11:35 UTC)
-

mcp-reddit-publisher

Instalação rápida

Credenciais Reddit

Claude Desktop / Claude Code

Codex

OpenCode

OpenAI Agents / outros clientes MCP

Ferramentas MCP disponíveis

Segurança por padrão

Exemplo de prompt depois de instalar

Desenvolvimento local

Licença

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

reddit-mcp