Usage Limits
Understanding how PlexMCP counts and limits usage across your organization.
What Counts as a Request?
A request is counted each time you call the PlexMCP API to interact with an MCP. This includes:
- Tool invocations: Calling a tool on an MCP
- Resource reads: Reading resources from an MCP
- Prompt completions: Getting prompts from an MCP
- Connection tests: Testing MCP connectivity from dashboard
What Doesn't Count
- Dashboard page views
- API key management
- Team management
- Viewing analytics
- Health check polling (automatic)
Plan Limits
Request Limits
| Plan | Monthly Requests |
|---|---|
| Free | 1,000 |
| Pro | 50,000 |
| Team | 500,000 |
| Enterprise | Custom |
MCP Limits
| Plan | Max MCPs |
|---|---|
| Free | 5 |
| Pro | 15 |
| Team | Unlimited |
Team Member Limits
| Plan | Max Members |
|---|---|
| Free | 1 |
| Pro | 5 |
| Team | Unlimited |
API Connection Limits
| Plan | Max API Connections |
|---|---|
| Free | 2 |
| Pro | 10 |
| Team | Unlimited |
Monitoring Usage
Dashboard View
- Go to Dashboard or Billing
- See current usage vs. limits
- View usage breakdown by day
Usage by MCP
See which MCPs consume the most:
- Go to MCPs
- View request counts per MCP
- Sort by usage
Usage by API Key
Track usage per key:
- Go to API Keys
- View request counts per key
- Identify high-usage keys
Usage Alerts
Configure notifications when approaching limits:
- Go to Billing → Alerts
- Set threshold (e.g., 80%)
- Choose notification method
- Save settings
Alert types:
- Warning (80%): Time to review usage
- Critical (95%): Consider upgrading
- Exceeded (100%): Action required
What Happens at Limits
Request Limits
Free Plan:
- API calls return
429 Too Many Requests - Service resumes at next billing period
- Can upgrade to continue immediately
Paid Plans:
- Overage charges apply ($0.001/request)
- No service interruption
- Invoice adjusted at period end
MCP Limits
When at MCP limit:
- Cannot add new MCPs
- Existing MCPs continue working
- Must delete or upgrade to add more
Team Member Limits
When at member limit:
- Cannot send new invites
- Existing members unaffected
- Remove member or upgrade to invite more
API Key Limits
When at key limit:
- Cannot create new keys
- Existing keys work normally
- Revoke unused keys or upgrade
Optimizing Usage
Reduce Unnecessary Calls
- Cache responses: Store results when appropriate
- Batch operations: Combine related calls
- Use webhooks: React to events vs. polling
Monitor for Issues
- Check error rates: Failed calls still count
- Review retry logic: Avoid excessive retries
- Audit API keys: Find and fix runaway integrations
Right-size Your Plan
If consistently near limits:
- Upgrade to next tier
- Consider annual billing for savings
- Contact sales for custom limits
If consistently under limits:
- Review if you need current tier
- Downgrade to save costs
Rate Limiting
In addition to monthly limits, PlexMCP enforces rate limits:
| Plan | Requests/second |
|---|---|
| Free | 10 |
| Pro | 100 |
| Team | 1,000 |
| Enterprise | Custom |
Rate limit responses:
- Status:
429 Too Many Requests - Header:
Retry-After: <seconds> - Body: Error message with wait time
Handling Rate Limits
async function callWithRetry(fn, maxRetries = 3) {
for (let i = 0; i < maxRetries; i++) {
try {
return await fn();
} catch (error) {
if (error.status === 429) {
const waitTime = error.headers['retry-after'] || 1;
await sleep(waitTime * 1000);
} else {
throw error;
}
}
}
throw new Error('Max retries exceeded');
}
Billing Period
- Start: Day of signup/upgrade
- End: Same day next month
- Reset: Limits reset at period start
Example:
- Signed up: January 15
- Billing date: 15th of each month
- Usage resets: Every 15th
FAQs
Do failed requests count?
Yes, all API calls count toward limits, including errors.
Can I prepay for requests?
Contact sales for custom request packages.
What's the grace period?
None on Free plan. Paid plans have automatic overage.
Can I set hard limits?
Yes, contact support to disable overages (paid plans).
How quickly does usage update?
Near real-time in dashboard, within ~1 minute.