Skip to main content
Glama
rag-nfl-analyst

rag-nfl-analyst

by JustinUbes

rag-nfl-analyst

RAG system and MCP server for NFL fantasy football applications.

This repository is the retrieval and context-serving layer for the fantasy-football-ai project. It owns the NFL data-source code that was split out of the app repo, plus the first MCP server entrypoint for retrieval-style tools.

What lives here

  • NFL stats ingestion helpers from nfl-data-py

  • MCP server entrypoint and tool surface

  • Future retrieval, embedding, indexing, and citation plumbing

Related MCP server: NFL MCP

Current layout

  • src/rag_nfl_analyst/data/nfl/stats.py - weekly NFL stats and related data helpers

  • src/rag_nfl_analyst/mcp/server.py - minimal MCP server with retrieval-oriented tools

  • docs/data-sources.md - current source map and usage notes

  • specs/implementation-plan.md - phased implementation plan for the retrieval stack

  • specs/open-questions.md - remaining decisions and design questions

Current state

The repo is intentionally thin right now:

  • source integrations are in place

  • an MCP server entrypoint exists

  • retrieval/indexing/storage layers are still planned

Getting started

uv sync
uv run rag-nfl-analyst

Notes

  • This repo is the right place for retrieval-specific code, not the final user-facing CLI or prompt formatting.

  • The app repo owns Sleeper and user/platform state; this repo only receives normalized context.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      A factual NFL data server that provides player search, profiles, statistics, schedules, rosters, and more via MCP tools, with automatic on-demand retrieval and transparent caching from nflverse.
      18
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that turns real NFL & fantasy data into a decisive edge, offering 70+ tools for draft assistance, start/sit recommendations, trade analysis, playoff odds, and more, with live league integration.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A read-only MCP server that supplies live context from Sleeper fantasy-football leagues, including rosters, trade analysis, draft picks, and league settings via Sleeper's public API.
      11
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that provides league-accurate fantasy football advice by scoring projections against your Sleeper league's actual scoring settings and roster shape, answering draft, trade, waiver, and lineup questions.
      MIT