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:

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

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

License

MIT — see LICENSE.