Was this page helpful?
Support
Zephex enforces limits at three levels: monthly account quota, per-minute burst rate, and optional per-key monthly caps. This page covers all three, plus overage billing and top-up packs.
| Tier | Requests/month | Burst (req/min) | API Keys | MCP Backends |
|---|---|---|---|---|
| Free | 300 | 50 | 3 | 1 |
| Pro ($7/mo) | 3,500 | 300 | Unlimited | 10 |
| Max ($19/mo) | 10,000 | 1,000 | Unlimited | 20 |
Monthly quotas reset on the 1st of each month at 00:00 UTC. If you upgrade mid-cycle, the higher limit applies immediately for the remainder of the month.
tools/call that reaches the Zephex endpoint — regardless of tool, duration, or response size.tools/list, initialize, ping, and connection handshakes.Burst limits use a sliding-window algorithm. If you exceed the per-minute cap, requests are rejected with error code -32002 and a Retry-After header indicating when to retry.
Burst limits exist to protect service stability. Normal interactive usage (an AI editor calling tools during a coding session) will never hit them. They primarily prevent runaway automation loops.
Pro and Max users can set a monthly request cap on individual API keys. This prevents a single integration from consuming the entire account quota.
Example: You have a Pro account (3,500/mo) with 3 keys:
production — cap: 2,000staging — cap: 500personal — cap: unlimitedIf production hits 2,000, it stops working. staging and personal continue until the account total reaches 3,500.
{ "jsonrpc": "2.0", "error": { "code": -32003, "message": "Per-key monthly cap reached", "data": { "key_prefix": "mcp_prod_cosmic-1861", "monthly_request_count": 1000, "monthly_request_cap": 1000, "reset_date": "2026-07-01T00:00:00Z" } }}Pro and Max users can enable overage billing from Dashboard → Billing. When enabled, requests beyond your monthly limit are metered and charged on your next invoice instead of being blocked.
| Tier | Overage rate | Billed |
|---|---|---|
| Pro | $0.003 per request | Added to next monthly invoice |
| Max | $0.002 per request | Added to next monthly invoice |
Overage billing can be toggled on or off at any time. When disabled, requests are blocked at the monthly limit. There is no minimum overage charge.
Instead of overage billing, you can purchase one-time request packs that add to your monthly balance immediately:
| Pack | Extra requests | Price | Per-request rate |
|---|---|---|---|
| Starter | 2,000 | $5 | $0.0025 |
| Growth | 4,000 | $10 | $0.0025 |
Top-up balances do not expire within the billing month. Unused top-up requests do not roll over to the next month. Purchase from Dashboard → Billing when you hit your limit.
Every response includes rate-limit headers so your client can track remaining quota:
HTTP/1.1 200 OKX-RateLimit-Limit: 3500X-RateLimit-Remaining: 2847X-RateLimit-Reset: 1717200000X-RateLimit-Burst-Limit: 300X-RateLimit-Burst-Remaining: 298| Header | Meaning |
|---|---|
| X-RateLimit-Limit | Monthly request cap for your tier |
| X-RateLimit-Remaining | Requests remaining this month |
| X-RateLimit-Reset | Unix timestamp when the monthly counter resets |
| X-RateLimit-Burst-Limit | Per-minute burst cap |
| X-RateLimit-Burst-Remaining | Burst requests remaining in the current window |
{ "jsonrpc": "2.0", "error": { "code": -32003, "message": "Monthly usage limit exceeded", "data": { "tier": "pro", "current_usage": 3500, "limit": 3500, "reset_date": "2026-07-01T00:00:00Z", "upgrade_url": "https://zephex.dev/dashboard/billing" } }}When you receive this error, your options are: wait for the monthly reset, purchase a top-up pack, enable overage billing, or upgrade your plan.
Zephex sends email notifications when you approach your limit. Default thresholds are 50%, 75%, and 90%. You can disable or customize these from Dashboard → Settings → Notifications.
Opt into a weekly email summary (sent Mondays at 9am UTC) showing your request count, top tools used, remaining quota, and reset date. Enable from Dashboard → Settings → Notifications → Weekly usage digest.
If you need more than 10,000 requests/month or custom rate limits, contact support@zephex.dev to discuss enterprise options.