Documentation menu

Rate limits & quotas

Each account has a daily quota of tool requests, set by its plan. Quotas are counted per account — across every client and credential you use — and reset at midnight UTC.

Last updated 2026-08-02

Daily quotas

Plan	Requests / day	Notes
Free	50	Core NFL stats, schedules, rosters, injuries, snap counts, and play search.
Pro	1,500	Every NFL MCP tool for lineup, matchup, market, and custom analysis.

Tool discovery does not draw down the quota. Calls to nfl_status and nfl_player_id_map are also unmetered, so account checks and bounded Sleeper ID mapping do not consume daily requests. Compare plans on the pricing page.

Unmetered tools

Unmetered does not mean unauthenticated. Every call still requires a valid OAuth session or API key, and plan authorization still applies. Only nfl_status and nfl_player_id_map are excluded from the daily counter; all other tool invocations are metered.

How usage is counted

Usage is tracked per account, not per credential. The daily counter is the sum of every tool request made by your account — whether you signed in with OAuth or sent an API key, and across every key you own, including keys you have since revoked. Creating or rotating keys does not reset it.

When quotas reset

The daily counter resets at 00:00 UTC. Usage is bucketed by the current UTC date, so a request at 23:59 UTC and one at 00:01 UTC count against different days regardless of your local time zone.

Exceeding the limit

Once the daily quota is reached, further tool requests are rejected at the transport layer with HTTP 429 and the following body. The upgrade_url is included when a higher tier is available.

HTTP 429 — quota_exceeded

{
  "error": {
    "code": "quota_exceeded",
    "message": "Daily free-tier limit reached (50 calls/day). Upgrade for higher limits: https://nflmcp.com/dashboard/usage",
    "upgrade_url": "https://nflmcp.com/dashboard/usage"
  }
}

This transport-level shape is distinct from the per-tool error envelope returned inside a successful response — see Error format.