Troubleshooting

Messages you may meet, in your assistant or from the tools, and what to do about them.

Connecting

You seeWhat it meansDo this
"Reconnect a connector to keep using it" (claude.ai)The connection was revoked, or its sign-in lapsed and could not renew.Press Reconnect and approve again.
401 with invalid_tokenThe key or connection is expired, revoked or mistyped. Connectors renew automatically while connected.Reconnect; or create a new key under API keys.
The assistant says it has no rnafold toolsThe connector is off for this chat.Turn rnafold on in the chat's tools menu.
Search box says "No results" when you paste the URLThat box only filters connectors you already have.Use Add, then Add custom connector.

Limits

You seeWhat it meansDo this
"Free-tier limit of 5 runs per month reached. The next slot opens in about N days. To keep going now, write to info@rnafold.com and we will set up paid access."Your monthly allowance is used. Every GPU fold and every analysis of a structure counts as one run.Wait for the next slot, or write to info@rnafold.com. The instant sequence tools (RNA secondary structure, primers, CRISPR guides, codon recoding, restriction digests, alignment) are not counted and still work.
"This run folds 3 complex(es) and each fold is one run; you have 2 left."A comparison needs more runs than you have. Nothing was started or charged.Fold fewer variants.
429, "limit of 120 requests per minute reached"A burst of calls.Wait the number of seconds in Retry-After; assistants usually retry.
503, "the server is busy"Many requests at once.Retry shortly.

Folds

You seeWhat it meansDo this
"No time can be quoted for this length"Longer than anything measured (about 290 nt). The fold still runs.Expect it to take longer than 19 minutes.
"fewer than two engines can take this sequence"Too long for a comparison. Nothing was started or spent.Fold a domain, or split it. estimate_fold shows how many engines fit.
"C20U: position 20 is G, not C"The wild-type letter in a mutation does not match your sequence, so the whole comparison was refused.Check the numbering against the sequence you pasted.
"Still running after 40 s. Call wait_for_job again."Normal: a fold takes minutes.Ask the assistant to keep waiting.
A job failedAn engine ran out of memory or crashed. A failed fold is refunded.Retry; if it repeats, tell us the job id.
"No analysis or pipeline run with that id on this account"The id is wrong, expired (results are kept 14 days), or belongs to another account.list_analyses shows yours.

Structures

You seeWhat it meansDo this
"the file is N characters, over max_chars" and no coordinatesThe structure is too large to return whole, and a partial PDB would silently drop residues.Ask for trace_only, or a higher max_chars (up to 400,000).
Structures from different engines will not load togetherOlder results may label the chain differently.All engines now use chain A, including for earlier jobs.

The answer itself

You seeDo this
One confident structure and no caveatsAsk the assistant to read the tool's caveats and to show where the engines disagree.
A claim that engines agreeing proves the foldIt does not; see What rnafold will not do. Ask for the earliest close relative.
"Error executing tool X" with no reasonReport it with the time. Tools now pass their reason through, so this should only be a genuine fault.

Last changed 2026-11-18