Documentation menu

nfl_injury_return

Pro tier

Injury return

PREFERRED for injury recovery / return-to-form questions. Returns post-return snap-share recovery as a percent of pre-injury baseline at +1..+8 weeks after an 'Out' spell, bucketed by normalized injury type (hamstring, knee, ankle, …) and position. 100 = fully back to baseline usage. Use for 'how long until players recover snaps after a hamstring injury'. Default sort is by weeks since return.

Minimum tier: Pro
Data coverage: Varies by query

Parameters

Name	Type	Required	Description
`injury_type`	string	Optional	Normalized injury bucket (partial match). Valid buckets: hamstring, knee, ankle, shoulder, concussion, groin, foot, calf, hip, back, quadriceps, achilles, wrist, hand, elbow, toe, thigh, neck, ribs, pectoral, other. Specific diagnoses are mapped to these buckets (e.g. 'ACL' -> knee, 'hammy' -> hamstring); anything unmatched -> other.
`position`	string	Optional	Position filter (e.g. WR, RB).
`week_post_return`	integer	Optional	Specific week offset after return (1–8).
`limit`	integer	Optional	Max rows (default 50, 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_injury_return",
    "arguments": {
      "limit": 10
    }
  }
}'

Example response

Excerpt · lists trimmed

{
  "injury_return": [
    {
      "injury_type": "ankle",
      "position": "C",
      "week_post_return": 1,
      "avg_snap_pct_recovery": 90,
      "median_snap_pct_recovery": 102.4,
      "sample_size": 6
    },
    {
      "injury_type": "ankle",
      "position": "FB",
      "week_post_return": 1,
      "avg_snap_pct_recovery": 65.9,
      "median_snap_pct_recovery": 65.9,
      "sample_size": 2
    },
    {
      "injury_type": "ankle",
      "position": "G",
      "week_post_return": 1,
      "avg_snap_pct_recovery": 114.9,
      "median_snap_pct_recovery": 106.9,
      "sample_size": 32
    }
  ],
  "count": 10
}

All tools