MCP Guide

Connect an MCP-compatible AI client to ReelsFarm so it can inspect assets, generate content, prepare publishing actions, and track results.

View Markdown

Endpoint

Remote MCP endpointtxt

https://mcp.reelsfarm.com/mcp

Use 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.

Bearer headerhttp

Authorization: Bearer rfmcp_xxx

API 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.

Example configjson

{
  "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.

Prompttxt

Check my ReelsFarm account, list connected publishing accounts, and list the latest scheduled posts. Do not create or publish anything.

Expected tools: get_account, list_connected_accounts, 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

Tool sequencetxt

prepare_generate_slideshow_text
  prompt: Summer serum launch
  slideCount: 6
  idempotencyKey: slideshow-summer-launch-001

confirm_action
  confirmationId: conf_123

get_slideshow_text_job_status
  jobId: job_123

In Review mode, prepare tools return a confirmationId and the agent should call confirm_action only after approval. In Creator or Autopilot, allowed prepare tools may execute immediately. Always reuse the same idempotencyKey when retrying a mutation.

Core tool groups

Group	Common tools
Account	get_account, get_mcp_server_info, get_queue_status, get_generation_pricing
Assets	list_assets, search_assets, create_product_upload_sessions, complete_product_upload_sessions, import_media_from_url, bulk_import_media
Generation	prepare_generate_avatar, prepare_generate_product_scene, prepare_generate_ugc_video, prepare_generate_hook, prepare_ai_clone_job
Slideshows	list_slideshows, get_slideshow, create_slideshow, prepare_generate_slideshow_text, prepare_finalize_slideshow, prepare_export_slideshow_video
Publishing	list_connected_accounts, prepare_schedule_post, prepare_publish_now, get_publish_status, list_scheduled_posts
Automations	list_automations, prepare_create_automation, prepare_update_automation
Events	get_recent_events