Revup

Crea, personaliza, previsualiza y genera informes sobre promociones en tu cuenta de Revup.

Ver en revup.comPrueba este MCPPatrocinado

Servidor MCP alojado

npx add-mcp 'https://revup.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Documentación de Revup MCP

Conecta tu asistente de IA a Revup para crear encuestas, formularios y otras promociones, personalizarlos y explorar el rendimiento desde una conversación.

URL del servidor

MCPhttps://revup.com/mcp

Revup proporciona un servidor de Model Context Protocol (MCP) alojado. Usa un cliente que admita conexiones HTTP Streamable remotas e inicio de sesión con OAuth.

Comienza conectando tu cuenta, verificando sus capacidades y pidiendo a tu asistente que encuentre una promoción.

Crear o editar una promoción puede afectar su página pública de inmediato. Su programación controla cuándo se aceptan las participaciones. No hay un paso separado de aprobación de publicación.

¿Estás creando una integración directa con claves de API? Consulta la referencia de la API.

What can I do in my connected Revup account?

Find my giveaways and show their current schedules.

Conecta tu asistente

En la configuración de conexión MCP de tu asistente, agrega un servidor remoto llamado Revup usando la URL del servidor de arriba.
Inicia el inicio de sesión con OAuth e inicia sesión en Revup.
Elige la cuenta que deseas conectar y revisa los permisos solicitados.
Selecciona Conectar, regresa a tu asistente y actualiza sus herramientas si es necesario.

La configuración de conexión disponible depende de tu cliente. Debe admitir MCP remoto y código de autorización OAuth con S256 PKCE. Las claves de API de Revup son para la API REST; esta conexión usa OAuth.

Puedes agregar Revup manualmente sin una lista de directorio publicada. Elige las instrucciones para ChatGPT, Claude o Codex a continuación. El plan de tu asistente y la configuración de la organización pueden limitar las conexiones personalizadas.

Confirma la conexión

Pide al asistente que llame a get_account_capabilities primero. Verifica la cuenta antes de hacer cambios. Las herramientas disponibles dependen de tus alcances consentidos, permisos de cuenta y operaciones admitidas.

Desconectar

Abre Cuenta › Integraciones, encuentra Conexiones MCP y elimina la conexión. Vuelve a conectar a través de tu asistente para autorizarla nuevamente.

Name: Revup
URL: https://revup.com/mcp
Transport: Streamable HTTP
Authentication: OAuth

Conectar ChatGPT

En ChatGPT, abre Configuración › Seguridad e inicio de sesión y habilita el Modo desarrollador. La disponibilidad depende de tu cuenta y la política del espacio de trabajo.
Abre Plugins, selecciona el botón + e ingresa Revup como nombre con una breve descripción.
En Conexión, ingresa la URL del servidor de Revup que se muestra en esta página y crea la conexión. Usa autenticación OAuth.
Inicia sesión en Revup, elige tu cuenta, revisa los permisos y selecciona Conectar.
Inicia una nueva conversación y selecciona la conexión de Revup desde el menú de herramientas. Pregunta qué cuenta de Revup está conectada antes de hacer cambios.

Si el Modo desarrollador o la creación de conexiones no están disponibles, consulta con el administrador de tu espacio de trabajo. Estos pasos usan una conexión personalizada; no requieren que Revup aparezca en el directorio público.

Consulta las instrucciones de conexión actuales de OpenAI para conocer la disponibilidad del cliente y los cambios en la interfaz.

Conectar Claude

En Claude, abre Personalizar › Conectores, selecciona + y luego Agregar conector personalizado.
Nombra el conector Revup y pega la URL del servidor que se muestra en esta página. Revup admite el registro automático de clientes OAuth; no necesitas proporcionar un ID de cliente o secreto.
Agrega el conector e inicia su conexión o flujo de inicio de sesión.
Inicia sesión en Revup, elige tu cuenta, revisa los permisos y selecciona Conectar.
En una conversación, usa + › Conectores para habilitar Revup y luego pregunta qué cuenta de Revup está conectada.

Para espacios de trabajo de Team y Enterprise, el propietario de la organización puede necesitar agregar el conector en la configuración de la organización antes de que los miembros puedan conectar sus propias cuentas de Revup.

Consulta las instrucciones de conector personalizado de Claude para conocer los requisitos actuales de plan y espacio de trabajo.

Conectar Codex

Con el CLI de Codex instalado, ejecuta los comandos que se muestran aquí para agregar Revup e iniciar el inicio de sesión con OAuth.
En el navegador, inicia sesión en Revup, elige tu cuenta, revisa los permisos y selecciona Conectar.
Regresa a Codex e inicia una nueva sesión. Pregunta qué cuenta de Revup está conectada y qué puede hacer.

Los permisos solicitados permiten la edición de promociones y la generación de informes agregados. offline_access permite que Codex actualice la conexión. Revisa estos permisos durante el inicio de sesión.

Usa la URL del entorno de Revup donde existe tu cuenta. Una conexión de staging accede a cuentas y promociones de staging.

Consulta las instrucciones MCP de Codex para otras opciones de configuración.

codex mcp add revup --url https://revup.com/mcp
codex mcp login revup --scopes account:read,promotions:read,promotions:write,analytics:read,offline_access

Permisos y acceso

Cada nueva conexión se aplica a todas las promociones de una cuenta de Revup, dentro de los permisos que permitas. Las herramientas respetan tu membresía y rol actuales en la cuenta. Las conexiones existentes con restricciones de promoción conservan esas restricciones.

Alcance	Acceso
`account:read`	Leer capacidades de la cuenta y operaciones permitidas.
`promotions:read`	Encontrar promociones, descubrir configuraciones, inspeccionar imágenes, verificar operaciones, validar y previsualizar.
`promotions:write`	Crear, editar y duplicar promociones admitidas; importar imágenes proporcionadas.
`analytics:read`	Leer informes agregados de promociones.
`offline_access`	Permitir que el cliente actualice su conexión sin iniciar sesión por cada token de acceso.

Para acceso de solo lectura a la cuenta, permite los alcances de lectura que necesites y omite promotions:write. offline_access solo controla la actualización de la conexión.

Las etiquetas de herramientas identifican lecturas, escrituras y escrituras sensibles. Las escrituras sensibles pueden afectar el contenido público de la promoción o enviar información fuera de la cuenta conectada. Revisa los detalles antes de aprobarlos en tu asistente; los controles de aprobación dependen del cliente.

Crear o duplicar una promoción requiere consentimiento de promoción a nivel de cuenta. Una conexión restringida a promociones específicas no puede crear nuevas.

MCP no expone identidades de participantes ni exportaciones, selección de ganadores, mensajería a participantes, pagos, suscripciones ni la creación de compras de participación.

Show the connected account and my permissions.

Which operations can I use for this promotion?

Descubre promociones y configuraciones

get_account_capabilities

Lectura · Sensible: No

Lee la cuenta conectada y las capacidades disponibles. No toma argumentos.

list_promotions

Lectura · Sensible: No

Encuentra promociones accesibles. Admite query, limit (1–50, predeterminado 20) y un cursor devuelto para la siguiente página.

get_promotion

Lectura · Sensible: No

Lee los detalles guardados usando promotion_id. Solicita un section específico para contenido, reglas, seguridad, diseño, campos, premios, acciones de bonificación o recursos. Usa la revisión devuelta al editar.

get_promotion_schema

Lectura · Sensible: No

Descubre las configuraciones admitidas antes de escribir. Pasa la sección que deseas editar, como content, fields, colors, assets o schedule. Usa los valores permitidos y catálogos devueltos.

{
  "name": "get_promotion_schema",
  "arguments": {
    "section": "content"
  }
}

Crear, editar y duplicar

create_promotion

Escritura · Sensible: Sí

Crea una promoción con name, schedule y idempotency_key. Opcionalmente, proporciona un operations estructurado descubierto desde el esquema. Crea una promoción con disponibilidad pública normal; su programación controla cuándo se aceptan las participaciones.

Establece type a giveaway, contest, form, instant_win, purchase o survey. Se requiere un tipo explícito; sweepstakes y purchase_rewards son alias aceptados. Las capacidades de la cuenta enumeran los tipos actualmente disponibles.

Si tu conector aún muestra la herramienta antigua solo de sorteos sin el parámetro type, agrega esto como la primera operación de creación. La entrada existente de operations lo admite:

[{"section":"content","action":"set","values":{"type":"survey"}}]

Reemplaza survey con el tipo disponible previsto. Si se envían ambas formas de selección de tipo, deben coincidir. Los tipos faltantes o conflictivos fallan sin crear una promoción. Esta operación se aplica solo durante la creación; no puede cambiar el tipo de una promoción existente. La reautorización por sí sola puede no actualizar las definiciones de herramientas guardadas del conector.

Las encuestas comienzan con una pregunta y CAPTCHA, sin correo electrónico ni otro identificador de contacto. Los campos de contacto son opcionales y se pueden eliminar antes de la primera respuesta real; después de eso, las preguntas se bloquean. Los formularios conservan su requisito de identificador existente. La integración de compras y la asignación de ganadores instantáneos requieren configuración en el panel y no se copian mediante la duplicación de MCP.

Create a customer feedback survey with no email field.

update_promotion

Escritura · Sensible: Sí

Aplica cambios ordenados con promotion_id, expected_revision, operations y idempotency_key. Las configuraciones omitidas se conservan. Aplicar un tema reemplaza todos los colores. Los cambios pueden afectar la página pública de inmediato.

duplicate_promotion

Escritura · Sensible: Sí

Copia la configuración admitida con un nuevo nombre y programación. Proporciona el promotion_id de origen, su expected_revision y un idempotency_key. Los participantes, resultados, integraciones, variantes de idioma y envíos no se copian. La copia completada tiene disponibilidad pública normal bajo su nueva programación.

get_operation_status

Lectura · Sensible: No

La duplicación se ejecuta de forma asíncrona. Consulta usando el job_id devuelto antes de trabajar con la nueva promoción.

La creación y las ediciones usan la disponibilidad normal de la promoción. Los cambios pueden afectar el contenido público de inmediato; no hay un paso separado de borrador o aprobación de publicación.

Resultados y preparación

Crear y actualizar aceptan response_mode: summary (predeterminado), minimal o full. Cada resultado exitoso incluye el ID de promoción guardado y la revisión, información de reintento, IDs de elementos secundarios creados o eliminados y preparación informativa. El resumen devuelve los cambios guardados; el completo también devuelve la configuración guardada dentro de los límites de paginación y respuesta.

Los esquemas de diseño documentan selectores, unidades, rangos y comportamiento responsivo admitidos. Prefiere los controles de color, fuente, diseño y tema. El CSS personalizado se sanitiza y se limita al alcance; lee el valor guardado después de una actualización porque las declaraciones no admitidas pueden eliminarse.

Programaciones y reintentos

Usa fechas locales en formato YYYY-MM-DD HH:MM:00 con una zona horaria IANA. Revup incluye el minuto final completo de la hora de finalización. Elige fechas apropiadas para tu promoción; el ejemplo es ilustrativo.

Lee la última revisión de la promoción antes de editar. Para un reintento después de un tiempo de espera, mantén la misma clave de idempotencia y argumentos idénticos. Usa una nueva clave para una nueva operación. Si la revisión guardada cambió, lee la promoción nuevamente y revisa los cambios antes de reintentar.

Las solicitudes exitosas se pueden reproducir durante siete días en la misma conexión, o hasta que esa conexión expire, lo que ocurra primero. Las respuestas de escritura incluyen retry.expires_at_utc. Después de esa ventana, la clave anterior se rechaza incluso después de la limpieza. Las claves de reintento no se transfieren cuando te reconectas: lee la promoción actual, el estado de la operación o del recurso antes de enviar otra escritura para evitar repetir una acción completada.

{
  "name": "create_promotion",
  "arguments": {
    "type": "giveaway",
    "name": "Autumn giveaway",
    "schedule": {
      "start": "2026-10-01 09:00:00",
      "end": "2026-10-31 17:00:00",
      "timezone": "America/Los_Angeles"
    },
    "idempotency_key": "autumn-giveaway-001"
  }
}

Usa tus imágenes

list_assets

Lectura · Sensible: No

Encuentra imágenes listas en la biblioteca de la cuenta conectada. Usa sus IDs de recurso estables con las configuraciones de imagen admitidas descubiertas a través de get_promotion_schema.

import_image

Escritura · Sensible: No

Importa una imagen proporcionada por el usuario o generada por el cliente usando un descriptor file que contenga download_url y file_id, más un idempotency_key. Los campos opcionales del descriptor son mime_type y file_name. Una ruta de archivo local o de sandbox no es un descriptor de archivo descargable. Almacena la imagen en la biblioteca de tu cuenta; adjuntarla a una promoción requiere una edición separada.

Los formatos admitidos son PNG, JPEG, WebP y GIF, hasta 5 MiB y 40 millones de píxeles. Revup importa las imágenes proporcionadas; no las genera.

get_asset_status

Lectura · Sensible: No

Consulta usando asset_id hasta que la imagen haya completado el procesamiento antes de adjuntarla a una promoción. Si tu cliente no puede proporcionar un archivo descargable, sube a través de la biblioteca de la cuenta de Revup y usa list_assets.

Find ready images in my Revup account library.

Show me the supported image slots for my giveaway
and use the image I select.

Vista previa y verificación de preparación

validate_promotion

Lectura · Sensible: No

Pasa promotion_id para inspeccionar los bloqueadores y advertencias de configuración guardados. La validación es solo informativa: no repara configuraciones ni impide el acceso público.

render_preview

Lectura · Sensible: No

Pasa promotion_id y viewport (desktop o mobile) para recibir un JPEG vinculado a la revisión de la promoción guardada. El resultado identifica la revisión realmente renderizada, las dimensiones del viewport, el tiempo de renderizado y cualquier advertencia de recursos incompletos. Captura el viewport visible, por lo que el contenido más abajo en la página puede no aparecer.

preview_promotion

Lectura · Sensible: No

Pasa promotion_id para obtener los enlaces estándar de vista previa, público y de compartir. La vista previa muestra la última promoción guardada y marca los envíos como pruebas.

Revisa el contenido guardado, las imágenes, las reglas, las fechas y la zona horaria antes de compartir el enlace público. Las entradas públicas siguen el cronograma normal y las reglas de entrada. Cerrar tu asistente no pausa la promoción.

Check this giveaway for readiness warnings.

Render desktop and mobile previews, show its public link, and confirm
when it will accept entries.

Leer informes de rendimiento

get_promotion_report

Lectura · Sensible: No

Lee métricas agregadas con promotion_id y un period que contenga fechas de inicio y fin. Opcionalmente, agrega un rango de fechas comparison y un breakdown: device, source, campaign o landing.

Los informes incluyen definiciones de métricas, denominadores, zona horaria, filtros y límites de frescura. Los recuentos de participantes, las probabilidades de entrada ponderadas y los completados contados son métricas diferentes. Los informes omiten identidades de participantes y rutas URL sin procesar.

Pide a tu asistente que separe los cambios observados de las posibles explicaciones. Un cambio de conversión o una comparación entre fuentes no establece su causa.

{
  "name": "get_promotion_report",
  "arguments": {
    "promotion_id": 123,
    "period": {
      "start": "2026-10-01",
      "end": "2026-10-31"
    },
    "breakdown": "source"
  }
}

Solución de problemas

Problema	Siguiente paso
Conexión no disponible	Confirma la URL del servidor y que tu cliente admita Streamable HTTP remoto y OAuth. Si Revup informa que no está disponible, inténtalo de nuevo más tarde o contacta con soporte.
Herramientas faltantes o permiso denegado	Verifica las capacidades de la cuenta, los alcances consentidos, tu rol en la cuenta y las restricciones de promoción. Vuelve a conectarte si necesitas un consentimiento diferente.
Conexión caducada o revocada	Deja que el cliente actualice su token o vuelva a conectarse mediante el inicio de sesión OAuth.
Conflicto de revisión o estado	Lee la promoción actual y concilia la edición prevista antes de enviar una nueva operación.
Imagen o duplicado aún en procesamiento	Consulta la herramienta de estado correspondiente. No inicies repetidamente una nueva importación o duplicación.
Límite de velocidad alcanzado	Espera antes de reintentar. Evita el sondeo rápido y conserva la misma clave y carga útil al reintentar escrituras de promoción o imagen.

submit_feedback

Escritura · Sensible: Sí

Informa un error de Revup, un comportamiento confuso o una capacidad faltante desde cualquier conexión, incluidas las de solo lectura. Pasa un category (bug, confusing o missing_capability) y un note de hasta 2,000 caracteres que describa qué intentabas hacer, qué ocurrió y qué esperabas. Opcionalmente, incluye tool_name, promotion_id y el request_id devuelto con un error de herramienta.

Almacena tu informe en Revup y puede notificar al equipo de Revup a través de Slack, fuera de tu cuenta conectada. El resultado es un feedback_id; tus promociones no cambian. Esta escritura permanece disponible con consentimiento de cuenta de solo lectura.

Cada llamada crea un informe separado, por lo que no reintentes automáticamente. Cada conexión puede enviar 10 informes por hora. No incluyas tokens, contraseñas ni datos personales.

El descubrimiento de herramientas es la referencia para la versión del servidor a la que está conectado tu cliente. Actualízalo después de una actualización. Para obtener ayuda, contacta con Revup con el nombre de la herramienta y el mensaje de error. No incluyas tokens, contraseñas ni URL de descarga privadas.

Read the latest saved promotion and explain
what changed before applying my edit again.