Documentation menu

nfl_coverage_splits

Pro tier

Coverage splits

PREFERRED for man-vs-zone coverage questions about a player. For a QB (role='passing') splits attempts, completion %, EPA, success rate, CPOE, air yards, TDs and INTs by man vs zone coverage; for a pass-catcher (role='receiving') splits targets, catch %, EPA, success rate, air yards and TDs. role='auto' (default) infers the side from the player's position. Use for 'is X better vs man or zone', 'who beats zone', 'which WR feasts vs man'. Coverage charting runs 2016 onward. Params: player (required), season or season_from/season_to, role (auto/passing/receiving), min_plays (per-bucket floor, default 10).

Minimum tier: Pro
Data coverage: 2016 onwards seasons

Parameters

Name	Type	Required	Description
`player`	string	Required	Player name — full ('Patrick Mahomes') or short ('P.Mahomes').
`season`	integer	Optional	Single season year.
`season_from`	integer	Optional	Start of a season range.
`season_to`	integer	Optional	End of a season range.
`role`	string	Optional	Split from the passing (QB) or receiving side; 'auto' infers from position.Options: auto, passing, receiving
`min_plays`	integer	Optional	Minimum plays per coverage bucket to include (default 10).

Example request

A Model Context Protocol tools/call over Streamable HTTP. Replace YOUR_API_KEY with a key from your dashboard.

curl -X POST https://mcp.nflmcp.com/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nfl_coverage_splits",
    "arguments": {
      "player": "Patrick Mahomes",
      "season": 2024
    }
  }
}'

Example response

{
  "player": "Patrick Mahomes",
  "role": "passing",
  "splits": [
    {
      "coverage": "man",
      "attempts": 328,
      "completions": 196,
      "completion_pct": 59.8,
      "avg_epa": 0.153,
      "success_pct": 48.2,
      "cpoe": 0.7,
      "avg_air_yards": 7.2,
      "touchdowns": 17,
      "interceptions": 6
    },
    {
      "coverage": "zone",
      "attempts": 387,
      "completions": 251,
      "completion_pct": 64.9,
      "avg_epa": 0.05,
      "success_pct": 48.8,
      "cpoe": 3.7,
      "avg_air_yards": 5.7,
      "touchdowns": 14,
      "interceptions": 7
    }
  ],
  "count": 2
}

All tools