Troubleshooting
Messages you may meet, in your assistant or from the tools, and what to do about them.
Connecting
| You see | What it means | Do 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_token | The 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 tools | The connector is off for this chat. | Turn rnafold on in the chat's tools menu. |
| Search box says "No results" when you paste the URL | That box only filters connectors you already have. | Use Add, then Add custom connector. |
Limits
| You see | What it means | Do 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 see | What it means | Do 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 failed | An 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 see | What it means | Do this |
|---|---|---|
| "the file is N characters, over max_chars" and no coordinates | The 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 together | Older results may label the chain differently. | All engines now use chain A, including for earlier jobs. |
The answer itself
| You see | Do this |
|---|---|
| One confident structure and no caveats | Ask the assistant to read the tool's caveats and to show where the engines disagree. |
| A claim that engines agreeing proves the fold | It does not; see What rnafold will not do. Ask for the earliest close relative. |
| "Error executing tool X" with no reason | Report it with the time. Tools now pass their reason through, so this should only be a genuine fault. |
Last changed 2026-11-18