{
  "error": {
    "message": "Rate limit exceeded for this API key",
    "code": "API_KEY_RATE_LIMITED",
    "suggestion": "This API key is limited to 60 requests/minute. Wait until the window resets (see the X-RateLimit-Reset header, a Unix timestamp) before retrying, or batch multiple operations into fewer requests.",
    "retryable": true
  }
}

async function withRetry(fn: () => Promise<Response>, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const res = await fn();
    if (res.status !== 429) return res;
    const delay = Math.min(1000 * 2 ** i + Math.random() * 1000, 30000);
    await new Promise(r => setTimeout(r, delay));
  }
  throw new Error('Rate limited after retries');
}

{
  "jsonrpc": "2.0",
  "id": null,
  "error": {
    "code": -32000,
    "message": "Rate limit exceeded (120 MCP requests/minute)",
    "data": {
      "suggestion": "Slow down and retry after the window resets (see the Retry-After header). Batch reads where possible, or ask a NexSpace admin to raise this credential’s rate limit.",
      "retryable": true
    }
  }
}