Documentation menu

nfl_plan

Free tier

Start analysis plan

Start an explicit multi-tool NFL analysis plan. Call this before a multi-step investigation to declare the canonical goal, intent, and entities. Pass the returned plan_id to every related tool call, then finish with nfl_complete_plan. Do not include private or sensitive information in the goal or entities.

Minimum tier: Free
Data coverage: Varies by query

Parameters

Name	Type	Required	Description
`intent`	string	Required	The canonical analysis intent.Options: fantasy, betting, player_analysis, team_analysis, matchup_analysis, data_exploration, other
`goal`	string	Required	A concise canonical question or goal. Summarize the task; do not copy private user information.
`entities`	array	Optional	Optional player, team, game, season, or week identifiers that define the analysis scope.
`planned_tools`	array	Optional	Optional NFL MCP tools the agent expects to use. This is a plan, not an execution allowlist.

Example request

A Model Context Protocol tools/call over Streamable HTTP. Replace YOUR_API_KEY with a key from your dashboard. This is a low-level request example; MCP clients manage protocol initialization and browser OAuth for you.

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_plan",
    "arguments": {
      "intent": "player_analysis",
      "goal": "Assess Justin Jefferson's recent usage and injury context.",
      "entities": [
        "Justin Jefferson"
      ],
      "planned_tools": [
        "nfl_game_log",
        "nfl_injuries",
        "nfl_role_trend"
      ]
    }
  }
}'

Example response

{
  "plan_id": "plan_8791bb4f8d624982b7dbbdf86ed7d1b3",
  "intent": "player_analysis",
  "goal": "Assess Justin Jefferson's recent usage and injury context.",
  "entities": [
    "Justin Jefferson"
  ],
  "planned_tools": [
    "nfl_game_log",
    "nfl_injuries",
    "nfl_role_trend"
  ],
  "status": "active",
  "next": "Pass plan_id to each related NFL tool call, then call nfl_complete_plan with the grounded answer and evidence."
}

Saved reference output, not a live production result. Query your authenticated connection for current data and read its coverage, freshness, and missing-result hints. Understand the limitations.

All tools