diff --git a/mcp-server.mdx b/mcp-server.mdx
index 008a407..62a284c 100644
--- a/mcp-server.mdx
+++ b/mcp-server.mdx
@@ -457,7 +457,7 @@ Tool failures come back as MCP tool errors with a short machine-readable prefix:
 | `idempotency_conflict` | An earlier call holds this call's duplicate-protection slot | No |
 | `idempotency_unavailable` | AnyAPI could not check for a duplicate, so nothing ran; safe to retry | No |
 | `provider_rejected_request` | The upstream rejected this request; adjust it before retrying | No |
-| `provider_rate_limited` | The upstream rate-limited the request; retry later | No |
+| `provider_rate_limited` | The upstream rate-limited the request; resend the same call a second later, with the same `cursor` if you sent one, rather than starting again from page 1. REST sends `Retry-After: 1` | No |
 | `provider_timeout` | Every available route ended in an upstream timeout | No (released) |
 | `site_not_supported` | Web scraping is not available for this site; the message names AnyAPI APIs built for that site, if there are any | No (released) |
 | `site_unreachable` | No route could reach this site within the last 24 hours (every route timed out, or the only answer after the timeouts was "not found"), so the call was refused before it ran; the message says when AnyAPI will try the site again. Only `web.*` calls can return it, because only there the site is the URL you gave | No |