# Troubleshooting

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

Canonical: /docs/troubleshooting.md

## 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 check**
```bash
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 mode**
```bash
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 again**
```bash
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 commands**
```bash
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 poll**
```bash
reelsfarm avatars generate --prompt "Creator selfie" --wait --timeout 300000
reelsfarm posts status --id post_123 --agent
```