Troubleshooting
Fast checks for auth, endpoint, plan, confirmation, validation, timeout, and agent-mode output issues.
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.
reelsfarm agent status --server-url https://mcp.reelsfarm.com/mcpAgent 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.
REELSFARM_AGENT_MODE=1 reelsfarm social connectedConfirmation failed
- Confirmations are short-lived.
- Confirming again returns the durable operation status or stored result; it never repeats a completed action.
- If the response is lost, call get_operation with the original operationId instead of preparing again.
- If a pending confirmation expires, start a new logical action with a new idempotencyKey.
- Do not call reelsfarm_confirm_action until the user has reviewed the summary.
reelsfarm slideshows generate-text --prompt "Launch slides" --agent
reelsfarm confirm conf_new --agentValidation errors
Run the command registry before retrying. It lists required flags, optional flags, safety level, and examples.
reelsfarm agent commandsLong-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.
reelsfarm avatars generate --prompt "Creator selfie" --wait --timeout 300000
reelsfarm posts status --id post_123 --agent