ReelFarm MCP Server

An MCP (Model Context Protocol) server for the ReelFarm API. Create slideshows, manage automations, publish to TikTok, search Pinterest for images, and more — all from any MCP-compatible AI client.

Tools

25 tools covering the full ReelFarm API:

Category	Tools
Account	get_account
Slideshows	generate_slideshow, create_slideshow, slideshow_status
Automations	create_automation, list_automations, get_automation, update_automation, delete_automation, run_automation
Schedules	add_schedule, update_schedule, delete_schedule
Videos	list_videos, get_video, get_video_analytics, publish_video_via_automation
TikTok	publish_to_tiktok, list_tiktok_accounts, list_tiktok_posts
Collections	list_collections, get_collection_images
Library	list_library_niches, search_library, get_library_profile
Pinterest	search_pinterest

Prerequisites

• uv (recommended) or pip
• A ReelFarm account on the Growth, Scale, or Enterprise plan
• A ReelFarm API key — get yours from Dashboard → Settings → API Keys

Quick Start

Add this to your MCP client's config file (replace rf_your_api_key_here with your actual key):

{
  "mcpServers": {
    "reelfarm": {
      "command": "uvx",
      "args": ["reelfarm-mcp"],
      "env": {
        "REELFARM_API_KEY": "rf_your_api_key_here"
      }
    }
  }
}

That's it. The config is the same for every client — the only difference is where the file lives.

Config file locations

Client	Config file	How to open
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · %APPDATA%\Claude\claude_desktop_config.json (Windows)	Claude → Settings → Developer → Edit Config
Cursor	.cursor/mcp.json in your project root	Settings → MCP → Add new MCP server
Windsurf	~/.codeium/windsurf/mcp_config.json	Windsurf Settings → Cascade → MCP → Add Server → Add custom server
VS Code (Copilot)	.vscode/mcp.json	Edit directly (uses "servers" instead of "mcpServers" — see below)

VS Code note: VS Code uses a "servers" key instead of "mcpServers":

{
  "servers": {
    "reelfarm": {
      "command": "uvx",
      "args": ["reelfarm-mcp"],
      "env": {
        "REELFARM_API_KEY": "rf_your_api_key_here"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add reelfarm \
  -e REELFARM_API_KEY=rf_your_api_key_here \
  -- uvx reelfarm-mcp

Verify it's registered:

claude mcp list

Any other MCP client (generic stdio)

The server communicates over stdio. Point your MCP client at:

REELFARM_API_KEY=rf_your_api_key_here uvx reelfarm-mcp

Installation (alternative to uvx)

If you prefer installing the package directly rather than using uvx:

pip install reelfarm-mcp

Then use "command": "reelfarm-mcp" (no args) in any of the configs above instead of uvx.

Using a local clone

If you're developing or want to run from source:

{
  "mcpServers": {
    "reelfarm": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/absolute/path/to/reelfarm-mcp",
        "reelfarm-mcp"
      ],
      "env": {
        "REELFARM_API_KEY": "rf_your_api_key_here"
      }
    }
  }
}

Or via Claude Code CLI:

claude mcp add reelfarm \
  -e REELFARM_API_KEY=rf_your_api_key_here \
  -- uv run --directory /absolute/path/to/reelfarm-mcp reelfarm-mcp

Usage Examples

Once connected, you can ask your AI assistant things like:

• "Generate a slideshow about 5 morning habits, casual tone, 6 slides"
• "List my automations and show which ones are active"
• "Create an automation that posts fitness slideshows to TikTok every day at 2pm Pacific"
• "Show me my TikTok post analytics for the last 30 days sorted by views"
• "Search Pinterest for aesthetic coffee images"
• "What niches are available in the slideshow library?"
• "How many credits do I have left?"

API Rate Limits

• 20 requests per 60-second sliding window
• Max 3 slideshows generating simultaneously

Development

git clone https://github.com/reelfarm/reelfarm-mcp.git
cd reelfarm-mcp
uv sync

# Run the server locally
REELFARM_API_KEY=rf_your_key uv run reelfarm-mcp

Troubleshooting

Problem	Fix
uvx: command not found	Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
Tools don't appear after config change	Restart the app (Claude Desktop, Cursor, etc.)
REELFARM_API_KEY is not set	Double-check the env block in your config — the key must start with rf_
FastMCP.__init__() got an unexpected keyword argument	Your mcp SDK is outdated or too new. Run uv sync to get compatible versions
Server seems to hang when run directly	This is normal — MCP servers communicate over stdio and produce no terminal output. Your MCP client launches it automatically

License

MIT — see LICENSE.