reelfarm-mcp 0.1.1

MCP server for the ReelFarm API — create slideshows, manage automations, publish to TikTok, and more.

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.