Documentation menu

nfl_catalog

Free tier

Catalog

Table discovery for unfamiliar data. Returns each loaded table's dataset id, row count, season coverage, last refresh time, and the nfl_schema arguments for inspecting its live columns. This tool discovers available datasets without exposing their column layout.

Minimum tier: Free
Data coverage: Varies by query

Parameters

Name	Type	Required	Description
`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_catalog",
    "arguments": {}
  }
}'

Example response

Excerpt · lists trimmed

{
  "tables": [
    {
      "dataset_id": "combine",
      "table_name": "combine",
      "total_rows": 8968,
      "seasons_loaded": 1,
      "min_season": null,
      "max_season": null,
      "last_loaded": "2026-03-07 00:45:46.462684",
      "schema": {
        "tool": "nfl_schema",
        "arguments": {
          "table": "combine"
        },
        "minimum_tier": "paid"
      }
    },
    {
      "dataset_id": "contracts",
      "table_name": "contracts",
      "total_rows": 50303,
      "seasons_loaded": 1,
      "min_season": null,
      "max_season": null,
      "last_loaded": "2026-03-07 00:45:44.598986",
      "schema": {
        "tool": "nfl_schema",
        "arguments": {
          "table": "contracts"
        },
        "minimum_tier": "paid"
      }
    },
    {
      "dataset_id": "dataset_coverage",
      "table_name": "dataset_coverage",
      "total_rows": 39,
      "seasons_loaded": 1,
      "min_season": null,
      "max_season": null,
      "last_loaded": "2026-09-24 19:31:14.347557",
      "schema": {
        "tool": "nfl_schema",
        "arguments": {
          "table": "dataset_coverage"
        },
        "minimum_tier": "paid"
      }
    }
  ],
  "total_tables": 44,
  "next_step": "Pro users can call nfl_schema with the table argument shown in each entry to inspect live columns."
}

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