waiverwatch

command module
v0.6.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 26, 2026 License: MIT Imports: 15 Imported by: 0

README

waiverwatch

An MCP server for Sleeper fantasy football. Ask Claude about all your leagues at once, from your laptop or your phone:

  • "How am I doing this week?" across every league
  • "Who's thin at RB in my dynasty league?"
  • "Which trending waiver pickups are still available in my leagues?"

The Sleeper app shows one league at a time. Fantasy needs reaction: an injury on Sunday gives you minutes to hit the waiver wire, wherever you are.

Status

Runs locally over stdio, and hosted on Cloud Run for claude.ai and the Claude mobile app. Tools so far: list_leagues, get_matchups, get_roster, compare_rosters, draft_results, injury_report, trending_players, waiver_targets. See the milestones for the plan.

Principles

  • Always fresh. Live data (rosters, matchups, waivers) is fetched from Sleeper on every request. Only the player dictionary is cached.
  • Read-only. Public Sleeper API, no account credentials, no scraping.
  • Claude is the UI. No web frontend.
  • Zero running cost. Free tiers only.

Stack

Piece Choice
Language Go
Interface MCP (Go SDK): stdio locally, Streamable HTTP when hosted
Host Google Cloud Run (free tier, scales to zero)
Data api.sleeper.app: public, free, no key

Use it locally

Install (needs Go; puts waiverwatch in $(go env GOPATH)/bin):

go install github.com/moudlajs/waiverwatch@latest

Claude Code:

claude mcp add --scope user waiverwatch -e WAIVERWATCH_USER=<your Sleeper username> -- "$(go env GOPATH)/bin/waiverwatch"

Claude Desktop: Settings → Developer → Edit Config, then add to claude_desktop_config.json (use the absolute path; Desktop doesn't read your shell's PATH):

{
  "mcpServers": {
    "waiverwatch": {
      "command": "/Users/<you>/go/bin/waiverwatch",
      "env": { "WAIVERWATCH_USER": "<your Sleeper username>" }
    }
  }
}

Restart Claude and ask "How are my fantasy leagues looking?"

Use it on claude.ai and your phone

The hosted server is for its owner only: it asks for a passphrase once per Claude app you connect.

  1. On claude.ai in a browser (connectors can't be added from the phone app): Customize → Connectors → Add custom connector.
  2. URL: https://<your Cloud Run URL>/mcp. Leave the OAuth fields empty; Claude uses its published client identity.
  3. Claude opens the waiverwatch sign-in page: enter the passphrase.
  4. The connector syncs to the Claude mobile app. Enable it per chat with + → Connectors.

To host your own, see CONTRIBUTING.md.

Tool Returns
list_leagues every league this season: type, size, your team, record, points, standing
get_matchups this week (or any week) in every league: live score, your and your opponent's starters with injuries; guillotine rank and margin over last place
get_roster a team's starters (by slot), bench, IR and taxi with injuries: yours, or any owner by name
compare_rosters your roster next to this week's opponent (or any owner), position by position, with records
draft_results your picks in every league (dynasty: startup and rookie drafts too); "where did I draft X?"
injury_report your injured players across all leagues, where they start for you, and a free replacement in each of those leagues
trending_players the most-added players on Sleeper, with the leagues where you can still claim each one
waiver_targets per league: the best free agents you can actually start there, your waiver priority or FAAB left

Contributing

See CONTRIBUTING.md.

Licence

MIT. Not affiliated with Sleeper.

Documentation

Overview

Command waiverwatch is an MCP server for Sleeper fantasy football. It speaks MCP over stdio for local clients (Claude Code, Claude Desktop), or over HTTP at /mcp when PORT is set (Cloud Run). Over HTTP it requires OAuth sign-in, configured by WAIVERWATCH_BASE_URL, WAIVERWATCH_PASSPHRASE and WAIVERWATCH_SIGNING_KEY; WAIVERWATCH_NO_AUTH=1 turns it off for local testing.

Directories

Path Synopsis
cmd
killswitch command
Command killswitch unlinks the project's billing account when its budget is spent.
Command killswitch unlinks the project's billing account when its budget is spent.
internal
auth
Package auth is waiverwatch's own small OAuth 2.1 authorization server, so that only the owner can use the hosted connector.
Package auth is waiverwatch's own small OAuth 2.1 authorization server, so that only the owner can use the hosted connector.
killswitch
Package killswitch turns billing off for the project when the budget is spent.
Package killswitch turns billing off for the project when the budget is spent.
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 as MCP tools and serves them as a transport.
Package mcp exposes waiverwatch as MCP tools and serves them as a transport.
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.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL