Warn Developers Before They Hit Rate Limits

import requests

API = "https://api.multimail.dev/v1"
HEADERS = {"Authorization": "Bearer mm_live_xxx"}

def send_usage_alert(developer: dict, usage: dict):
    pct = (usage["current"] / usage["limit"]) * 100
    days_remaining = calculate_days_until_exhaustion(
        usage["current"], usage["limit"], usage["daily_rate"]
    )

    body = (
        f"Hi {developer[&"cm">#039;name']},\n\n"
        f"Heads up: You&"cm">#039;ve used {usage['current']:,} of "
        f"{usage[&"cm">#039;limit']:,} monthly emails ({pct:.0f}%).\n\n"
        f"At your current rate of {usage[&"cm">#039;daily_rate']:,}/day, "
        f"you&"cm">#039;ll hit your limit in approximately {days_remaining} days.\n\n"
        f"Options:\n"
        f"1. Upgrade your plan: https://app.example.com/billing\n"
        f"2. Optimize usage: https://docs.example.com/rate-limits\n"
        f"3. Contact us: reply to this email\n\n"
        f"Current plan: {usage[&"cm">#039;plan']}\n"
        f"Usage resets: {usage[&"cm">#039;reset_date']}"
    )

    return requests.post(
        f"{API}/send",
        headers=HEADERS,
        json={
            "from": "[email protected]",
            "to": developer["email"],
            "subject": f"Heads up: You&"cm">#039;ve used {pct:.0f}% of your monthly API quota",
            "text_body": body
        }
    ).json()

import requests

API = "https://api.multimail.dev/v1"
HEADERS = {"Authorization": "Bearer mm_live_xxx"}

def send_rate_limit_notification(developer: dict, limit: dict):
    body = (
        f"Hi {developer[&"cm">#039;name']},\n\n"
        f"Your application has hit the {limit[&"cm">#039;type']} rate limit "
        f"for your {limit[&"cm">#039;plan']} plan.\n\n"
        f"Current limit: {limit[&"cm">#039;requests_per_second']} req/s\n"
        f"Your peak rate: {limit[&"cm">#039;peak_rate']} req/s\n\n"
        f"Immediate steps:\n"
        f"1. Implement exponential backoff on 429 responses\n"
        f"2. Cache responses where possible\n"
        f"3. Upgrade for higher limits: https://app.example.com/billing\n\n"
        f"Rate limiting guide: https://docs.example.com/rate-limits"
    )

    return requests.post(
        f"{API}/send",
        headers=HEADERS,
        json={
            "from": "[email protected]",
            "to": developer["email"],
            "subject": f"Rate limit reached - {limit[&"cm">#039;type']} ({limit['plan']} plan)",
            "text_body": body
        }
    ).json()

"cm">// API usage alert via MCP

const usage = await getApiUsage(developerId);
const pct = (usage.current / usage.limit) * 100;

if (pct >= 85) {
  await mcp.send_email({
    from: "[email protected]",
    to: developer.email,
    subject: `Heads up: You've used ${Math.round(pct)}% of your monthly API quota`,
    text_body: `Hi ${developer.name}, you've used ${usage.current.toLocaleString()} of ${usage.limit.toLocaleString()} monthly emails. Upgrade your plan to avoid throttling.`
  });

  await mcp.add_contact({
    email: developer.email,
    tags: ["usage-warning-sent", `plan-${usage.plan}`]
  });
}