Documentation menu

nfl_player_props

Pro tier

Player props

Use for current NFL player-prop lines and prices. Returns a compact player/market block with book-level over/under prices, one injury block, and one freshness block. A canonical market_key is required to prevent oversized all-prop responses. Use analytical player tools to research an edge; this tool reports markets and does not recommend or execute bets.

Minimum tier: Pro
Data coverage: Varies by query

Parameters

Name	Type	Required	Description
`game_id`	string	Optional	Exact NFL game ID.
`player`	string	Optional	Player name; full and short forms accepted.
`gsis_id`	string	Optional	Exact GSIS ID; may be passed without player.
`team`	string	Optional	Player team abbreviation.
`season`	integer	Optional	NFL season year.
`week`	integer	Optional	NFL week.
`market_key`	string	Required	Required canonical player-prop market.Options: player_passing_yards, player_passing_touchdowns, player_interceptions, player_rushing_yards, player_rushing_attempts, player_receiving_yards, player_receptions, player_anytime_td
`bookmaker`	string	Optional	Optional lowercase bookmaker key.
`include_dfs`	boolean	Optional	Include DFS flat-payout projections (default false).
`limit`	integer	Optional	Max grouped player/market results (default 25).
`offset`	integer	Optional	Row offset for pagination.
`plan_id`	string	Optional	Optional analysis correlation ID returned by nfl_plan. Pass the same plan_id to every tool call that belongs to that analysis.

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_player_props",
    "arguments": {
      "game_id": "2026_03_LAC_BUF",
      "player": "Josh Allen",
      "team": "BUF",
      "market_key": "player_passing_touchdowns",
      "limit": 10
    }
  }
}'

Example response

Excerpt · lists trimmed

{
  "props": [
    {
      "game_id": "2026_03_LAC_BUF",
      "player": {
        "name": "Josh Allen",
        "gsis_id": "00-0034857",
        "team": "BUF"
      },
      "market": {
        "key": "player_passing_touchdowns",
        "line": 1.5
      },
      "books": [
        {
          "bookmaker": "bet365",
          "over": -130,
          "under": 100,
          "updated_at": "2026-09-25 01:15:22"
        },
        {
          "bookmaker": "betrivers",
          "over": -152,
          "under": 116,
          "updated_at": "2026-09-25 01:50:33"
        },
        {
          "bookmaker": "bovada",
          "over": -150,
          "updated_at": "2026-09-25 02:01:27"
        }
      ],
      "injury": {
        "status": "Active",
        "updated_at": "2026-09-25 01:52:35.212054"
      }
    }
  ],
  "count": 1,
  "book_count": 8,
  "freshness": {
    "observed_at": "2026-09-25 02:06:16.276021",
    "provider_updated_at": "2026-09-25 02:01:27",
    "live": false
  }
}

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