AvataReel
Documentação

AvataReel MCP

O servidor MCP do AvataReel permite que seu assistente de IA use sua conta AvataReel. Ele pode escolher avatares, escrever roteiros, gerar vídeos e comprar créditos, com a sua confirmação.

Visão geral

MCP (Model Context Protocol) é um padrão aberto que conecta assistentes de IA a aplicativos. O AvataReel oferece um servidor MCP via HTTP. Você conecta uma vez com uma chave de API pessoal, e seu assistente ganha os mesmos recursos que você usa no app.

Início rápido

  1. 1. Crie uma chave de API

    No AvataReel, abra Configurações, encontre "Assistentes de IA (MCP)", dê um nome à chave e crie. Copie na hora: ela só aparece uma vez. Abrir Configurações

  2. 2. Adicione o servidor ao seu cliente

    Cole isto na configuração MCP do seu cliente e troque avr_… pela sua chave.

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

    No Claude Code, execute:

    claude mcp add --transport http avatareel https://api.avatareel.com/mcp --header "Authorization: Bearer avr_…"
  3. 3. Peça o que precisar

    Peça com palavras simples. O assistente escolhe as ferramentas, mostra o preço antes de gastar créditos e envia o link do vídeo quando ficar pronto.

O que você pode pedir

Você pedeO assistente
“Faça um anúncio de 30 segundos para minha cafeteria com um avatar simpático.”Lista avatares, escreve o roteiro, mostra o preço, gera o vídeo e envia o link de download.
“Escreva um roteiro a partir desta página de produto.”Lê a página e cria um roteiro UGC e uma cena.
“Faça três versões com ganchos diferentes.”Escreve novas aberturas e gera um vídeo para cada uma.
“Quantos créditos eu tenho? Compre mais.”Mostra seu saldo e as ofertas, e envia um link de pagamento com cartão ou um código Pix.
“Crie um avatar a partir desta foto.”Envia a foto, cria o avatar e avisa quando estiver pronto.
“Cancele meu plano.”Inicia o cancelamento e pergunta a você antes de confirmar.

Ferramentas

Estas são as ferramentas que o servidor oferece. Seu assistente escolhe por você; os nomes ajudam quando você quer pedir uma diretamente.

Vídeos

Ver preço, criar, acompanhar, tentar de novo e compartilhar vídeos.

  • 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

Roteiros

Escrever, reescrever e traduzir roteiros, ou começar por uma página de produto.

  • 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 e vozes

Ver avatares e vozes, ou criar um avatar a partir de uma foto ou descrição.

  • 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

Edição

Trocar roupa e fundo, editar vídeos prontos e usar o editor de movimento.

  • 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

Criar e baixar vários vídeos de uma vez. Requer vídeos em lote na sua conta.

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

Marca e produtos

Kits de marca, logos e fotos de produto salvas.

  • 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 e pagamento

Saldo, histórico, pacotes de créditos, planos, Pix e cancelamento.

  • 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

Conta e ajuda

Perfil, exclusão da conta e suporte.

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

Créditos e pagamento

Os vídeos usam os mesmos créditos do app. O assistente faz um orçamento antes e mostra o preço antes de criar um vídeo.

Quando seus créditos acabam, o assistente mostra os pacotes e planos da sua conta. Ele envia um link para pagar com cartão ou um código Pix para pagar no app do seu banco. Os créditos chegam assim que o pagamento é confirmado.

Segurança

  • Sua chave de API age como você, inclusive para gastar créditos. Guarde em segredo, como uma senha.
  • Revogue uma chave em Configurações quando quiser. Ela para de funcionar na próxima solicitação.
  • Bons assistentes perguntam antes de pagar, cancelar ou excluir. Revise esses pedidos antes de aprovar.
  • Chaves de API só acessam recursos de cliente. Elas não podem criar nem revogar outras chaves.

Erros

Quando algo falha, a ferramenta retorna o status HTTP e uma mensagem. Os mais comuns:

400
Dados inválidos. A mensagem diz o que corrigir.
401
Chave de API ausente, errada ou revogada.
402
Créditos insuficientes. Compre créditos e tente de novo.
403
Sua conta não tem este recurso.
429
Muitas solicitações. Aguarde um pouco e tente de novo.
AvataReel MCP: crie vídeos de anúncio pelo seu assistente de IA