AvataReel
Docs

AvataReel MCP

The AvataReel MCP server lets your AI assistant use your AvataReel account. It can pick avatars, write scripts, render videos and buy credits, with your confirmation.

Overview

MCP (Model Context Protocol) is an open standard that connects AI assistants to apps. AvataReel offers an MCP server over HTTP. You connect it once with a personal API key, and your assistant gets the same features you use in the app.

Quick start

  1. 1. Create an API key

    In AvataReel, open Settings, find "AI assistants (MCP)", name the key and create it. Copy it right away: we show it only once. Open Settings

  2. 2. Add the server to your client

    Paste this into your client's MCP configuration and replace avr_… with your key.

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

    In Claude Code, run:

    claude mcp add --transport http avatareel https://api.avatareel.com/mcp --header "Authorization: Bearer avr_…"
  3. 3. Ask for what you need

    Ask in plain words. The assistant picks the tools, shows the price before it spends credits, and gives you the video link when it is ready.

What you can ask

You askThe assistant
“Make a 30-second ad for my coffee shop with a friendly avatar.”Lists avatars, writes the script, shows the price, renders the video and returns the download link.
“Write a script from this product page.”Reads the page and drafts a UGC script and a scene.
“Make three versions with different hooks.”Writes new openings and renders one video for each.
“How many credits do I have? Buy more.”Shows your balance and the offers, then gives you a card payment link or a Pix code.
“Create an avatar from this photo.”Uploads the photo, creates the avatar and tells you when it is ready.
“Cancel my plan.”Starts the cancellation and asks you before it confirms.

Tools

These are the tools the server offers. Your assistant chooses them for you; the names help when you want to ask for one directly.

Videos

Price, create, follow, retry and share 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

Scripts

Write, rewrite and translate scripts, or start from a product page.

  • 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

Avatars and voices

Browse avatars and voices, or create an avatar from a photo or a description.

  • 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

Editing

Change outfit and background, edit finished videos and use the motion editor.

  • 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

Batches

Create and download many videos at once. Needs batch videos on your account.

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

Brand and products

Brand kits, logos and saved product photos.

  • 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

Credits and payment

Balance, history, credit packs, plans, Pix and cancellation.

  • 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

Account and help

Profile, account deletion and support.

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

Credits and payment

Videos use the same credits as the app. The assistant gets a quote first and shows you the price before it creates a video.

When you run out, the assistant shows the packs and plans for your account. It gives you a link to pay by card or a Pix code to pay in your bank app. Credits arrive as soon as the payment is confirmed.

Security

  • Your API key acts as you, including spending credits. Keep it secret, like a password.
  • Revoke a key in Settings at any time. It stops working on the next request.
  • Good assistants ask before they pay, cancel or delete. Review those requests before you approve them.
  • API keys only reach customer features. They can't create or revoke other keys.

Errors

When something fails, the tool returns the HTTP status and a message. The most common ones:

400
Invalid input. The message lists what to fix.
401
Missing, wrong or revoked API key.
402
Not enough credits. Buy credits and try again.
403
Your account doesn't have this feature.
429
Too many requests. Wait a little and try again.
AvataReel MCP: create ad videos from your AI assistant