Rate Limits

MCPWP rate limits requests per API key to protect server resources.

Defaults

Plan	Requests per minute
Free	60
Pro	120

Check current status

curl https://YOUR-SITE.com/wp-json/mcpwp/v1/rate-limit \
  -H "X-API-Key: $KEY"

Returns:

{
  "limit": 60,
  "remaining": 42,
  "reset": 1718900460
}

Configure

In WP Admin → MCPWP → Settings, or via REST:

curl -X PUT https://YOUR-SITE.com/wp-json/mcpwp/v1/rate-limit \
  -H "X-API-Key: $KEY" \
  -H "Content-Type: application/json" \
  -d '{"requests_per_minute": 120}'

Reset (admin only)

curl -X POST https://YOUR-SITE.com/wp-json/mcpwp/v1/rate-limit/reset \
  -H "X-API-Key: $ADMIN_KEY"

Batch endpoint

Use /batch to combine multiple operations into one request, reducing rate limit consumption:

POST /wp-json/mcpwp/v1/batch
{
  "requests": [
    { "method": "GET", "path": "/pages" },
    { "method": "GET", "path": "/site-info" }
  ]
}