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.
  • 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.
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

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.

Wait or pollbash
reelsfarm avatars generate --prompt "Creator selfie" --wait --timeout 300000
reelsfarm posts status --id post_123 --agent
SDK bounded waitts
const snapshot = await rf.avatars.getJobStatus("job_123", { waitMs: 25000 });
console.log(snapshot.jobProgress);