Rate Limits by Tier

Detailed information about rate limits for each BlokMCP subscription tier.

Rate Limit Tiers

Free Tier

Requests per minute: 10
Total monthly requests: 500
Concurrent requests: 2
Best for: Testing, personal projects, evaluation

Starter Tier

Requests per minute: 60
Total monthly requests: 10,000
Concurrent requests: 5
Best for: Small teams, small websites, blogs

Pro Tier

Requests per minute: 100
Total monthly requests: 50,000
Concurrent requests: 10
Best for: Growing businesses, medium-sized websites

Enterprise Tier

Requests per minute: 1,000
Total monthly requests: 500,000
Concurrent requests: 50
Best for: Large organizations, high-traffic sites, agencies

What Counts as a Request

Each API operation counts as one request:

Content operations: (1 request each)

Get story
Create story
Update story
Publish story
Delete story

Batch operations: (Varies)

Bulk publish: 1 request per story
Fetch multiple: 1 request per page

Asset operations: (1 request each)

Upload asset
Update asset metadata
Delete asset

Schema operations: (1 request each)

Get component
Update component

Rate Limit Headers

API responses include rate limit information:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1640000000

Exceeding Limits

Minute Limit Exceeded

Error 429: Too Many Requests
Retry-After: 60 seconds

What happens:

Request is rejected
Must wait until next minute window
BlokMCP automatically retries

Monthly Limit Exceeded

Error 429: Monthly quota exceeded

What happens:

All requests blocked until next month
Or upgrade to higher tier
Contact support for emergency increase

Optimization Tips

See Rate Limiting Guide for:

How to optimize API usage
Batch operation strategies
Caching techniques
Request minimization

Upgrading

When to consider upgrading:

Regularly hitting minute limits
Approaching monthly quota
Need faster operations
Growing team size

Questions about limits? Contact support at [email protected] or check your current usage in the dashboard at https://blokmcp.com