AdRecast

AdRecast MCP サーバー

AdRecast は、実績のある e コマース動画広告を商品向けに作り直します。参考広告のショット、テンポ、フックを分析し、確認用のスクリプトを作成した後、商品と出演者を使った複数シーンの広告全体を生成します。すべてのフレームで商品が正確に描写されているかも確認します。

エンドポイント

• URL: https://adrecast.com/api/mcp
• トランスポート: Streamable HTTP。
• 認証: API キーのみ。Bearer トークンとして送信します: Authorization: Bearer rk_live_...
  • Settings → API keys でキーを作成します。read、write、spend からスコープを選択します。
  • キーが表示されるのは一度だけです。作成時に安全な場所へ保存してください。
  • OAuth はサポートされていません。

機能

この MCP サーバーは、ウェブアプリと同じ作り直しのワークフローを実行します。テンプレートの検索 → 商品画像のアップロード → スクリプトの確認 → 見積もり → 生成 → 状態の確認 → エクスポート、という流れです。

ツールは全部で 46 個あり、分野ごとに分類されています。この分類はこの README 独自のもので、ドキュメントではエンドポイントごとにツールが記載されています。

• テンプレートとアップロード: search_templates、create_upload_url
• プロジェクト: create_project、list_projects、get_project、get_script、update_script、rewrite_script、get_rewrite、add_line、delete_line、reorder_lines、confirm_script
• 生成とエクスポート: estimate_cost、generate_video、list_jobs、list_clips、get_job、export_video、get_export
• キャラクターと音声: create_character、list_characters、delete_character、update_character、clone_character_voice、keep_character_voice、list_voices、set_project_character
• バリエーション: list_hook_formulas、list_variant_styles、create_hook_variant、estimate_variants、create_variants、list_variants、get_variant_manifest、add_variant_product、cancel_variant_batch
• Studio: studio_quote、create_studio_generation、list_studio_generations、list_studio_assets、get_studio_generation、confirm_studio_video、discard_studio_video、save_studio_output
• アカウント: get_balance

動画はシーンごとに生成され、すべてのショットで同じ出演者、商品、音声が使われます。字幕、ナレーションまたは曲、音楽が含まれます。動画全体を作り直さずに、ショットを1つだけ修正できます。

支出の安全対策

• 料金はクレジット単位です。100 クレジット = $1。分析、スクリプト、ストーリーボード用の静止画、動画生成前のスクリプト編集は無料です。
• 動画の料金は生成秒数に応じて発生します。720p は 40 クレジット/秒、1080p は 50、2K は 60 です。解像度はプロジェクト作成時に固定されます。
• generate_video と export_video は、confirm: true の場合にのみクレジットを消費します。指定しない場合は見積もりが返されます（402 confirmation_required）。confirm: true を設定する前に estimate_cost を呼び出し、見積もりをユーザーに提示してください。
• 1:1 または 16:9 に再フレームする export_video は、20 クレジット/秒かかります。9:16 のエクスポートは無料です。
• 動画生成後にショットを修正すると、作り直した秒数分の動画料金の 80% がかかります。
• clone_character_voice は固定で 1000 クレジットを消費します。また、confirm: true も必要です。
• プロジェクトを作成するには、先に $1 のトライアルを利用するか、チャージする必要があります（そうでない場合は 402 payment_required）。
• 自動生成（create_project の auto_generate=true）には spend スコープが必要です。
• Studio の料金は、対応する作り直しの料金の 0.8 倍です。
• 失敗したジョブでは、保留されていたクレジットが返却されます。
• REST 呼び出しでは、作成または支出を伴うすべての POST に Idempotency-Key を送信してください。これにより、再試行による二重請求を防げます。

クイックスタート

Settings → API keys で API キーを作成し、クライアントを実行するシェルでエクスポートします。

export ADRECAST_API_KEY=rk_live_...

汎用 MCP クライアント

url と headers を受け付ける任意のクライアントで、次の JSON を使用します。

{
  "mcpServers": {
    "adrecast": {
      "url": "https://adrecast.com/api/mcp",
      "headers": { "Authorization": "Bearer ${ADRECAST_API_KEY}" }
    }
  }
}

Claude Code

claude mcp add --transport http adrecast https://adrecast.com/api/mcp --header "Authorization: Bearer $ADRECAST_API_KEY"

Cursor

.cursor/mcp.json に次の内容を追加します。

{
  "mcpServers": {
    "adrecast": {
      "url": "https://adrecast.com/api/mcp",
      "headers": { "Authorization": "Bearer ${ADRECAST_API_KEY}" }
    }
  }
}

Codex

~/.codex/config.toml に次の内容を追加します。

[mcp_servers.adrecast]
url = "https://adrecast.com/api/mcp"
bearer_token_env_var = "ADRECAST_API_KEY"

examples/ フォルダーには、これらのスニペットが個別のファイルとして含まれています。

プロンプトの例

• 「車内での自撮りスキンケアUGCテンプレートを探して、私の商品向けに1080pで作り直す場合の見積もりを出してください。」
• 「この商品写真3枚をアップロードし、「課題 → あおり → 解決」テンプレートからプロジェクトを開始して、何かを生成する前にスクリプトを見せてください。」
• 「保証を最初に打ち出し、30秒を目標にするようスクリプトを書き直して、更新した行を見せてください。」
• 「このプロジェクト向けに3種類のフックを計画して、見積もりを見せてください。承認するまで実行しないでください。」
• 「クレジット残高を確認して、このプロジェクトの2Kエクスポートが残高内で可能か教えてください。」

リンク

• ウェブサイト：https://adrecast.com/en
• 料金：https://adrecast.com/en/pricing
• テンプレート：https://adrecast.com/en/templates
• ユースケース：https://adrecast.com/en/use-cases
• 事例（実際の出力と参考広告）：https://adrecast.com/en/cases
• API と MCP のドキュメント：https://adrecast.com/en/docs/api
• お問い合わせ：https://adrecast.com/en/contact
• 全ページのインデックス：https://adrecast.com/llms-full.txt

ライセンス

このサーバーは、AdRecast が運営するホステッドサービスです。このリポジトリには、ドキュメントと設定例のみが含まれています（MIT）。