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
All 12 generation, import, and export job status tools accept waitMs from 0 through 25000. Omit it or use 0 for an immediate snapshot. A bounded wait returns when recorded progress changes, the job ends, or the wait budget expires. This option does not apply to publishing or operation status tools. Read jobProgress.step, terminal, nextPollAfterMs, and available batch counts. Check item results for partial failures even when a batch completes.
reelsfarm avatars generate --prompt "Creator selfie" --wait --timeout 300000
reelsfarm posts status --id post_123 --agentconst snapshot = await rf.avatars.getJobStatus("job_123", { waitMs: 25000 });
console.log(snapshot.jobProgress);