AvataReel
Documentación

AvataReel MCP

El servidor MCP de AvataReel permite que tu asistente de IA use tu cuenta de AvataReel. Puede elegir avatares, escribir guiones, generar videos y comprar créditos, con tu confirmación.

Resumen

MCP (Model Context Protocol) es un estándar abierto que conecta asistentes de IA con aplicaciones. AvataReel ofrece un servidor MCP por HTTP. Lo conectas una vez con una clave de API personal y tu asistente obtiene las mismas funciones que usas en la app.

Inicio rápido

  1. 1. Crea una clave de API

    En AvataReel, abre Configuración, busca "Asistentes de IA (MCP)", ponle nombre a la clave y créala. Cópiala enseguida: solo la mostramos una vez. Abrir Configuración

  2. 2. Agrega el servidor a tu cliente

    Pega esto en la configuración MCP de tu cliente y reemplaza avr_… con tu clave.

    {
      "mcpServers": {
        "avatareel": {
          "type": "http",
          "url": "https://api.avatareel.com/mcp",
          "headers": {
            "Authorization": "Bearer avr_…"
          }
        }
      }
    }

    En Claude Code, ejecuta:

    claude mcp add --transport http avatareel https://api.avatareel.com/mcp --header "Authorization: Bearer avr_…"
  3. 3. Pide lo que necesites

    Pide con palabras simples. El asistente elige las herramientas, muestra el precio antes de gastar créditos y te da el enlace del video cuando está listo.

Qué puedes pedir

Tú pidesEl asistente
“Haz un anuncio de 30 segundos para mi cafetería con un avatar amigable.”Lista avatares, escribe el guion, muestra el precio, genera el video y te da el enlace de descarga.
“Escribe un guion a partir de esta página de producto.”Lee la página y redacta un guion UGC y una escena.
“Haz tres versiones con ganchos distintos.”Escribe nuevas aperturas y genera un video para cada una.
“¿Cuántos créditos tengo? Compra más.”Muestra tu saldo y las ofertas, y te da un enlace de pago con tarjeta o un código Pix.
“Crea un avatar a partir de esta foto.”Sube la foto, crea el avatar y te avisa cuando está listo.
“Cancela mi plan.”Inicia la cancelación y te pregunta antes de confirmar.

Herramientas

Estas son las herramientas que ofrece el servidor. Tu asistente las elige por ti; los nombres ayudan cuando quieres pedir una directamente.

Videos

Cotizar, crear, seguir, reintentar y compartir videos.

  • quote_video
  • create_video
  • wait_for_video
  • list_videos
  • get_video
  • get_video_steps
  • retry_video
  • delete_video
  • create_videos_from_brief
  • create_hook_variations
  • generate_post_caption
  • create_product_image_upload
  • create_character_swap_upload
  • complete_character_swap_upload
  • create_character_swap_image_upload
  • complete_character_swap_image_upload
  • claim_video_guarantee
  • get_video_feedback
  • send_video_feedback
  • submit_post_link
  • list_listing_images
  • create_listing_images
  • regenerate_listing_image

Guiones

Escribir, reescribir y traducir guiones, o empezar desde una página de producto.

  • list_scripts
  • generate_script
  • generate_guided_script
  • script_from_url
  • rewrite_script
  • translate_script
  • generate_hooks
  • suggest_avatar
  • preview_speech
  • preview_voice
  • generate_batch_scripts

Avatares y voces

Explorar avatares y voces, o crear un avatar a partir de una foto o una descripción.

  • list_avatars
  • get_avatar
  • list_voices
  • get_avatar_quota
  • create_avatar_photo_upload
  • assess_avatar_photo
  • generate_avatar_face
  • create_avatar
  • confirm_avatar_likeness
  • get_avatar_source_photo
  • replace_avatar_photo
  • set_avatar_voice
  • create_voice_recording_upload
  • merge_voice_takes
  • retry_avatar
  • delete_avatar

Edición

Cambiar ropa y fondo, editar videos terminados y usar el editor de movimiento.

  • classify_video
  • check_product_script
  • suggest_wardrobe
  • create_background_upload
  • create_brand_logo_upload
  • create_scene_image_upload
  • preview_appearance
  • change_appearance
  • get_video_captions
  • edit_video
  • get_motion_editor_access
  • create_motion_edit
  • create_automatic_motion_edit
  • get_motion_edit
  • get_video_motion_edit
  • save_motion_edit
  • direct_motion_edit
  • add_motion_soundtrack
  • export_motion_edit

Lotes

Crear y descargar muchos videos a la vez. Requiere videos en lote en tu cuenta.

  • quote_video_batch
  • create_video_batch
  • get_video_batch
  • get_video_batch_download
  • create_batch_motion_edits
  • list_batch_motion_edits

Marca y productos

Kits de marca, logos y fotos de producto guardadas.

  • list_brand_kits
  • create_brand_kit
  • brand_kit_from_brief
  • update_brand_kit
  • list_brand_assets
  • generate_brand_asset
  • delete_brand_kit
  • list_product_assets
  • create_product_asset_upload
  • complete_product_asset_upload

Créditos y pago

Saldo, historial, paquetes de créditos, planes, Pix y cancelación.

  • get_credit_balance
  • list_credit_transactions
  • list_unseen_refunds
  • get_billing_offers
  • create_pack_checkout
  • create_pix_charge
  • get_payment_order
  • get_subscription
  • create_subscription_checkout
  • create_subscription_pix
  • get_subscription_pix
  • change_subscription
  • start_subscription_cancel
  • accept_cancel_offer
  • confirm_subscription_cancel
  • create_billing_portal
  • get_billing_profile
  • update_billing_profile

Cuenta y ayuda

Perfil, eliminación de cuenta y soporte.

  • get_profile
  • update_profile
  • create_profile_photo_upload
  • delete_account
  • send_support_report
  • ask_support

Créditos y pago

Los videos usan los mismos créditos que la app. El asistente pide una cotización primero y te muestra el precio antes de crear un video.

Cuando te quedas sin créditos, el asistente muestra los paquetes y planes de tu cuenta. Te da un enlace para pagar con tarjeta o un código Pix para pagar en la app de tu banco. Los créditos llegan en cuanto se confirma el pago.

Seguridad

  • Tu clave de API actúa como tú, incluso para gastar créditos. Mantenla en secreto, como una contraseña.
  • Revoca una clave en Configuración cuando quieras. Deja de funcionar en la siguiente solicitud.
  • Los buenos asistentes preguntan antes de pagar, cancelar o eliminar. Revisa esas solicitudes antes de aprobarlas.
  • Las claves de API solo acceden a funciones de cliente. No pueden crear ni revocar otras claves.

Errores

Cuando algo falla, la herramienta devuelve el estado HTTP y un mensaje. Los más comunes:

400
Datos no válidos. El mensaje indica qué corregir.
401
Clave de API ausente, incorrecta o revocada.
402
No tienes suficientes créditos. Compra créditos e inténtalo de nuevo.
403
Tu cuenta no tiene esta función.
429
Demasiadas solicitudes. Espera un poco e inténtalo de nuevo.
AvataReel MCP: crea videos publicitarios desde tu asistente de IA