Documentation menu

nfl_team_similarity

Pro tier

Team similarity

Nearest-neighbor team comps: which past team-season is a given team most like? Compares within-season z-scored profiles (offense/defense EPA, scoring, third-down and red-zone efficiency, turnover margin, penalty rate, explosive-play and sack rate) so era differences don't drive the match, then ranks by Euclidean distance. Returns the top-N most similar team-seasons with a distance score and the features driving each match. Data covers 2013-2025. Params: team and season (required), top_n (default 5), exclude_same_franchise (default false).

Minimum tier: Pro
Data coverage: Varies by query

Parameters

Name	Type	Required	Description
`team`	string	Required	Team abbreviation (e.g. KC, PHI).
`season`	integer	Required	Season year to find comps for.
`top_n`	integer	Optional	Number of neighbors to return (default 5).
`exclude_same_franchise`	boolean	Optional	Exclude other seasons of the same team (default false).

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_team_similarity",
    "arguments": {
      "team": "KC",
      "season": 2023,
      "top_n": 5
    }
  }
}'

Example response

Excerpt · lists trimmed

{
  "team": "KC",
  "season": 2023,
  "neighbors": [
    {
      "team": "KC",
      "season": 2014,
      "distance": 1.405,
      "top_matching_features": [
        {
          "feature": "points allowed per game",
          "value": 17.5625,
          "target_value": 17
        },
        {
          "feature": "offensive EPA/play",
          "value": 0.03,
          "target_value": 0.014
        },
        {
          "feature": "turnover margin",
          "value": -5,
          "target_value": -7
        }
      ]
    },
    {
      "team": "NO",
      "season": 2013,
      "distance": 1.617,
      "top_matching_features": [
        {
          "feature": "red-zone TD %",
          "value": 13.1,
          "target_value": 12.8
        },
        {
          "feature": "sack rate",
          "value": 0.0392,
          "target_value": 0.0386
        },
        {
          "feature": "offensive EPA/play",
          "value": 0.066,
          "target_value": 0.014
        }
      ]
    },
    {
      "team": "TEN",
      "season": 2021,
      "distance": 1.747,
      "top_matching_features": [
        {
          "feature": "defensive EPA/play",
          "value": -0.045,
          "target_value": -0.065
        },
        {
          "feature": "third-down conversion %",
          "value": 39.3,
          "target_value": 39.5
        },
        {
          "feature": "points per game",
          "value": 24.1667,
          "target_value": 22.1905
        }
      ]
    }
  ],
  "count": 5
}

All tools