Reels Farm

Troubleshooting

Fast checks for auth, endpoint, plan, confirmation, validation, timeout, and agent-mode output issues.

View Markdown

Connection fails

  • Check that the endpoint is https://mcp.reelsfarm.com/mcp.
  • Check that the request uses Authorization: Bearer rfmcp_xxx for API key auth.
  • Check that the API key has not been revoked or deleted.
  • Check that the account has an active paid plan for MCP access.
CLI checkbash
reelsfarm agent status --server-url https://mcp.reelsfarm.com/mcp

Agent output is not parseable

Use --agent or set REELSFARM_AGENT_MODE=1. Agent mode prints strict JSON envelopes on stdout for both success and error cases.

Agent modebash
REELSFARM_AGENT_MODE=1 reelsfarm social connected

Confirmation failed

  • Confirmations are short-lived.
  • Each confirmation can be used once.
  • If a confirmation expires, prepare the action again.
  • Do not call confirm_action until the user has reviewed the summary.
Prepare againbash
reelsfarm slideshows generate-text --prompt "Launch slides" --agent
reelsfarm confirm conf_new --agent

Validation errors

Run the command registry before retrying. It lists required flags, optional flags, safety level, and examples.

Inspect commandsbash
reelsfarm agent commands

Long-running jobs

Generation can return an async job. Use --wait for simple scripts, or poll the matching status command when your agent needs more control.

Wait or pollbash
reelsfarm avatars generate --prompt "Creator selfie" --wait --timeout 300000
reelsfarm posts status --id post_123 --agent