Start from the stable error code and next_action on the receipt. Do not invent a parallel recovery path.

Connection and workspace

Symptom	What to do
Host cannot connect	Verify the URL is `https://mcp.everyn.ai/mcp` and complete OAuth.
Wrong organization	Disconnect in the host and connect again. Select the intended membership at consent. There is no `organization_id` argument. Inspect the bound workspace in MCP settings.
`unauthorized` / `forbidden`	Reconnect from MCP settings or the host. Confirm the user still belongs to that organization.
WorkOS failed	Stop. Do not fall back to an API key.

See Authentication and Connect.

Upload

Symptom	What to do
`payload_too_large`	Stay at or under 25 MiB.
`transfer_expired`	Call `upload_csv` with the same unfinished `upload_id` to refresh.
`digest_mismatch`	Recalculate `sha256:` and retry the transfer.
Host cannot move bytes	Use `client_can_transfer: false` and `https://app.everyn.ai/datasets`, then `search_datasets`.
Local path rejected	Expected. Upload through `upload_csv` or the Datasets page.

See Datasets and Help: upload failed.

Waiting and progress

Symptom	What to do
Wait returned without terminal	Call `get_run` again. The 25-second cap is per wait, not per Run.
Host disconnected	The Run continues. Resume waiting with `get_run`.
`stall_suspicion`	Inspect `get_run` and the Run page handoff. Do not start a duplicate Run.
`unknown_state`	Fail closed. Do not guess a transition.

See Runs and Help: run stuck or failed.

Billing admission

Open Usage and Billing at https://app.everyn.ai/settings. MCP cannot checkout, add funds, change plans, or update payment methods.

A paused Run after wallet exhaustion preserves completed work. Resume it; do not start a second full Run over the same work unless the user asked.

Export and download

Symptom	What to do
`not_ready`	Keep waiting with `get_run`.
Download expired	Call `export_run` again to refresh the delivery descriptor.
Analyzed only the preview	Download the complete-results CSV. Preview is at most 50 rows.

See Export.

Still stuck

Include the privacy-safe support_reference from the receipt when you contact help@everyn.ai. Do not attach tokens, descriptors, or raw CSV. See Contact support.

Troubleshooting