Documentation menu

nfl_ftn_charting

Pro tier

Scheme tendencies

PREFERRED for play-style / scheme tendency questions (2022–present). Returns aggregated FTN manual charting rates over offensive scrimmage plays (pass + run): play-action, RPO, screen, no-huddle, pre-snap motion, and trick-play usage, plus average defenders in the box (per scrimmage play) and pass rushers / blitzers (per dropback). Use for questions like 'how often does KC run play action' or 'what motion rate did Mahomes see'. Offensive perspective (team = offense). Set group_by='team' to rank all offenses by motion rate. Requires ftn_charting dataset.

Minimum tier: Pro
Data coverage: 2022 onwards seasons

Parameters

Name	Type	Required	Description
`team`	string	Optional	Offensive team abbreviation (e.g. KC, PHI).
`opponent`	string	Optional	Defensive team abbreviation.
`player`	string	Optional	Player name — full ('Justin Jefferson') or short ('J.Jefferson') both accepted. Matches passer, rusher, or receiver.
`season`	integer	Optional	Exact season year (2022–present). Use season_from/season_to for ranges.
`season_from`	integer	Optional	Start of season range (inclusive).
`season_to`	integer	Optional	End of season range (inclusive).
`week`	integer	Optional	Week number (1–22).
`season_type`	string	Optional	Filter by season type: REG or POST.Options: REG, POST
`group_by`	string	Optional	Break the charting rates out per offense and return a list ranked by motion rate, for comparing/ranking teams.Options: team
`limit`	integer	Optional	Max teams when group_by='team' (default 100, max 500).

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_ftn_charting",
    "arguments": {
      "team": "KC",
      "season": 2024
    }
  }
}'

Example response

{
  "charting": {
    "total_plays": 1228,
    "play_action": {
      "plays": 170,
      "pct": 13.8
    },
    "rpo": {
      "plays": 77,
      "pct": 6.3
    },
    "screen_pass": {
      "plays": 88,
      "pct": 7.2
    },
    "no_huddle": {
      "plays": 21,
      "pct": 1.7
    },
    "motion": {
      "plays": 718,
      "pct": 58.5
    },
    "trick_play": {
      "plays": 14,
      "pct": 1.1
    },
    "avg_defenders_in_box": 6.12,
    "avg_pass_rushers": 4.25,
    "avg_blitzers": 0.32
  },
  "total_plays": 1228
}

All tools