Reddit Ads MCP Connector

Plain-language MCP for Reddit Ads API v3
API base: https://ads-api.reddit.com/api/v3

Pregunta en inglés sencillo — no necesitas memorizar las rutas de los endpoints ni los IDs de cuentas de anuncios (cuando hay una cuenta configurada).

Lo que puede hacer

Related MCP server: Google Ads API v20 MCP Server

Requisitos previos

1. Una aplicación de Reddit en reddit.com/prefs/apps — tipo aplicación web o script

2. Anota el ID de cliente (bajo el nombre de la aplicación) y el secreto de cliente

3. Un token de actualización con el alcance adsread (OAuth de una sola vez — ver más abajo)

Configuración (local)

cd reddit-mcp-connector
python -m venv .venv
# Windows:
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env

Rellena .env:

REDDIT_CLIENT_ID=your_client_id
REDDIT_CLIENT_SECRET=your_secret
REDDIT_REFRESH_TOKEN=your_refresh_token
REDDIT_USER_AGENT=web:reddit-mcp-connector:v1.0.0 (by /u/YOUR_USERNAME)
REDDIT_AD_ACCOUNT_ID=t2_xxxxx   # optional but recommended

Inicia el servidor:

python reddit_mcp_server.py --http

Escucha en http://127.0.0.1:8002/mcp.

Obtener un token de actualización (una sola vez)

1. Construye una URL de autorización (sustituye los marcadores de posición):

https://www.reddit.com/api/v1/authorize?client_id=YOUR_CLIENT_ID&response_type=code&state=anything&redirect_uri=http://localhost:8080&duration=permanent&scope=adsread

2. Ábrela en un navegador, aprueba el acceso y copia el code de la URL de redirección.

3. Intercambia el código:

curl -X POST https://www.reddit.com/api/v1/access_token ^
  -u "CLIENT_ID:CLIENT_SECRET" ^
  -d "grant_type=authorization_code&code=CODE&redirect_uri=http://localhost:8080"

4. Guarda refresh_token de la respuesta JSON en .env como REDDIT_REFRESH_TOKEN.

Tu URI de redirección en la configuración de la aplicación de Reddit debe coincidir exactamente (p. ej., http://localhost:8080).

Cursor (local)

"reddit": {
  "url": "http://127.0.0.1:8002/mcp"
}

1. Mantén el servidor en ejecución: python reddit_mcp_server.py --http

2. Cursor Configuración → MCP → actualizar

3. reddit debería mostrarse en verde con herramientas como list_campaigns, get_performance_report, …

Luego pregunta: “List my campaigns” o “Spend and impressions last 7 days”.

Google Cloud Run

Aloja el mismo endpoint HTTP MCP en Cloud Run.

Despliegue

.\deploy-cloudrun.ps1 -ProjectId "YOUR_GCP_PROJECT_ID"

Las credenciales se almacenan en Secret Manager como JSON (reddit-mcp-credentials). El script solicita los valores que falten o los lee de .env.

Cursor (Cloud Run)

"reddit": {
  "url": "https://YOUR-CLOUD-RUN-URL/mcp"
}

Conector personalizado de Claude

Cuando MCP_PUBLIC_URL está definida (el script de despliegue lo hace automáticamente), se habilita OAuth + DCR de Claude.ai.

1. Despliega con .\deploy-cloudrun.ps1 -ProjectId "..."

2. Configuración → Conectores → Añadir conector personalizado

3. URL: https://YOUR-SERVICE.run.app/mcp (debe incluir /mcp)

4. Deja vacío el ID de cliente de OAuth (DCR habilitado)

Ejemplos de prompts

• "List my Reddit ad accounts"

• "Show campaigns for my ad account"

• "Spend and impressions last 7 days"

• "Daily performance trend this month"

• "Break down performance by campaign"

• "List conversion pixels"

Herramientas

Nota de seguridad

El despliegue en Cloud Run usa --allow-unauthenticated para que la URL MCP sea accesible. El OAuth de Claude restringe el acceso a las herramientas a los clientes registrados. Trata las credenciales y las URLs como información sensible.