README
¶
waiverwatch
Ask Claude about all your Sleeper fantasy football leagues at once, from your laptop or your phone.
- "How am I doing this week?" across every league
- "Is my lineup right, and who should I pick up?"
- "Is Gibbs for Ja'Marr Chase and a 2027 1st fair in my dynasty league?"
The Sleeper app shows one league at a time; waiverwatch answers across all of them, with live scores, projections and trade values.
Add it to Claude
-
On claude.ai in a browser: Customize → Connectors → Add custom connector, name
waiverwatch, URL:https://waiverwatch-44okyiteea-ew.a.run.app/mcp -
Click Add, then Connect, and sign in with your Sleeper username. No password; it only reads public Sleeper data.
-
On your phone, switch it on per chat under + → Connectors, and ask.
Gemini, troubleshooting and limits: docs/connector.md.
What you can ask
Game day (matchups, lineups, injuries), waivers (who to pick up, FAAB bids), trades (values, fair or not, who to target), playoff chances and draft history. Examples and every tool: docs/questions.md.
Good to know
Projections and trade values are estimates for standard, half or full PPR. waiverwatch stores nothing about you and never logs usernames (privacy). It's a free hobby project, so it may be slow or down sometimes. Not affiliated with Sleeper, FantasyCalc or DynastyProcess.
Run it yourself
Locally in Claude Code or Claude Desktop: docs/local.md. Hosting your own: CONTRIBUTING.md. How it's built: docs/how-it-works.md.
Development
See CONTRIBUTING.md. Plan: the milestones; changes: the changelog.
License
Documentation
¶
Overview ¶
Command waiverwatch is an MCP server for Sleeper fantasy football: stdio for WAIVERWATCH_USER, or OAuth-protected HTTP at /mcp when PORT is set.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
killswitch
command
Command killswitch is a Cloud Run service that unlinks billing when the budget is spent.
|
Command killswitch is a Cloud Run service that unlinks billing when the budget is spent. |
|
internal
|
|
|
auth
Package auth is waiverwatch's small stateless OAuth 2.1 authorization server: users sign in with a Sleeper username, codes and tokens are HMAC-signed.
|
Package auth is waiverwatch's small stateless OAuth 2.1 authorization server: users sign in with a Sleeper username, codes and tokens are HMAC-signed. |
|
dynastyprocess
Package dynastyprocess is a read-only client for DynastyProcess's open dynasty values, joined to Sleeper IDs through their ID table.
|
Package dynastyprocess is a read-only client for DynastyProcess's open dynasty values, joined to Sleeper IDs through their ID table. |
|
fantasycalc
Package fantasycalc is a read-only client for FantasyCalc's public trade values.
|
Package fantasycalc is a read-only client for FantasyCalc's public trade values. |
|
killswitch
Package killswitch unlinks the project's billing account when a budget's Pub/Sub notification reports actual cost at or over budget (GCP has no hard spending cap).
|
Package killswitch unlinks the project's billing account when a budget's Pub/Sub notification reports actual cost at or over budget (GCP has no hard spending cap). |
|
league
Package league holds the fantasy logic: joins between rosters, owners and players.
|
Package league holds the fantasy logic: joins between rosters, owners and players. |
|
mcp
Package mcp exposes waiverwatch's league.Service as MCP tools over stdio or HTTP.
|
Package mcp exposes waiverwatch's league.Service as MCP tools over stdio or HTTP. |
|
sleeper
Package sleeper is a read-only client for the public Sleeper API.
|
Package sleeper is a read-only client for the public Sleeper API. |
|
sleeper/sleepertest
Package sleepertest runs a fake Sleeper API for tests, so no test ever touches the real one.
|
Package sleepertest runs a fake Sleeper API for tests, so no test ever touches the real one. |
|
store
Package store holds what waiverwatch keeps between requests: only the player dictionary.
|
Package store holds what waiverwatch keeps between requests: only the player dictionary. |