Reels Farm MCP Guide for AI Agents
Connect an MCP-compatible AI client to ReelsFarm so it can inspect assets, generate content, prepare publishing actions, and track results.
Endpoint
https://mcp.reelsfarm.com/mcpUse this URL anywhere your MCP client asks for a remote Streamable HTTP MCP server. The server is stateless and expects authenticated POST requests.
Authentication
ReelsFarm MCP supports OAuth and API key bearer tokens. OAuth is best when the client supports browser authorization. API keys are best for CLI-style setup, agent config files, and controlled personal workflows.
Authorization: Bearer rfmcp_xxxAPI keys are shown once
Create MCP API keys in the ReelsFarm account MCP tab. Store the key immediately. The raw key is not returned by list tools or account settings later.
Generic client config
MCP client config shapes vary. Use the endpoint and bearer token fields below when your client supports remote HTTP MCP servers.
{
"mcpServers": {
"reelsfarm": {
"type": "http",
"url": "https://mcp.reelsfarm.com/mcp",
"headers": {
"Authorization": "Bearer rfmcp_xxx"
}
}
}
}First check
After connecting, ask the agent to inspect the account and publishing state before preparing work.
Check my ReelsFarm account, list connected publishing accounts, and list the latest scheduled posts. Do not create or publish anything.- Expected tools: reelsfarm_get_account, reelsfarm_list_connected_accounts, reelsfarm_list_scheduled_posts.
- If those work, auth and tool discovery are working.
- If they fail, check the bearer token, active plan, and endpoint URL.
Prepare and confirm
reelsfarm_prepare_generate_slideshow_text
prompt: Summer serum launch
slideCount: 6
idempotencyKey: slideshow-summer-launch-001
reelsfarm_confirm_action
confirmationId: conf_123
reelsfarm_get_slideshow_text_job_status
jobId: job_123In Review mode, prepare tools return a confirmationId. The agent should call reelsfarm_confirm_action only after approval. In Creator or Autopilot, allowed prepare tools can execute immediately. Always reuse the same idempotencyKey when retrying a mutation.
Core tool groups
| Group | Common tools |
|---|---|
| Account | reelsfarm_get_account, reelsfarm_get_mcp_server_info, reelsfarm_get_queue_status, reelsfarm_get_generation_pricing |
| Assets | reelsfarm_list_assets, reelsfarm_search_assets, reelsfarm_create_product_upload_sessions, reelsfarm_complete_product_upload_sessions, reelsfarm_import_media_from_url, reelsfarm_bulk_import_media |
| Generation | reelsfarm_prepare_generate_avatar, reelsfarm_prepare_generate_product_scene, reelsfarm_prepare_generate_ugc_video, reelsfarm_prepare_generate_hook, reelsfarm_prepare_ai_clone_job |
| Slideshows | reelsfarm_list_slideshows, reelsfarm_get_slideshow, reelsfarm_create_slideshow, reelsfarm_prepare_generate_slideshow_text, reelsfarm_prepare_finalize_slideshow, reelsfarm_prepare_export_slideshow_video |
| Publishing | reelsfarm_list_connected_accounts, reelsfarm_preflight_publishing, reelsfarm_prepare_schedule_post, reelsfarm_prepare_publish_now, reelsfarm_get_publish_status, reelsfarm_list_scheduled_posts |
| Automations | reelsfarm_list_automations, reelsfarm_prepare_create_automation, reelsfarm_prepare_update_automation |
| Events | reelsfarm_get_recent_events |
MCP 3.0 publishing migration
| MCP 2.x | MCP 3.0 |
|---|---|
| socialConnectionId | connectionId |
| externalSocialAccountId | connectionId |
| tiktokPostMode: DRAFT | tiktokPublishMode: DRAFT |
| tiktokPostMode: PRIVATE | tiktokPublishMode: DIRECT, tiktokPrivacyLevel: SELF_ONLY |
| tiktokPostMode: PUBLIC | tiktokPublishMode: DIRECT, tiktokPrivacyLevel: PUBLIC_TO_EVERYONE |
Call reelsfarm_preflight_publishing before scheduling or publishing. ReelsFarm repeats preflight before execution. Billing setup, OAuth setup, credentials, webhook management, and permanent deletion remain dashboard-only.