# MCP Guide

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

Canonical: /docs/mcp.md

## Endpoint

**Remote MCP endpoint**
```txt
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 header**
```http
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 config**
```json
{
  "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.

**Prompt**
```txt
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 sequence**
```txt
prepare_generate_slideshow_text
  prompt: Summer serum launch
  slideCount: 6

confirm_action
  confirmationId: conf_123

get_slideshow_text_job_status
  jobId: job_123
```

Prepare tools do not execute the final action immediately. They return a confirmationId. The agent should show the summary to the user, then call confirm_action only after approval.

## Core tool groups

| Group | Common tools |
| --- | --- |
| Account | get_account, get_mcp_server_info, get_queue_status, get_generation_pricing |
| Assets | list_assets, search_assets, 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 |
| 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, prepare_delete_automation |
| Events | create_webhook, list_webhooks, get_recent_events |