waiverwatch

command module
v0.1.0 Latest Latest
Warning

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

Go to latest
Published: Sep 25, 2026 License: MIT Imports: 12 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

Early: runs locally over stdio. Tools so far: list_leagues. 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?"

Tool Returns
list_leagues every league this season: type, size, your team, record, points, standing

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; add it to Claude Code or Claude Desktop.

Directories

Path Synopsis
internal
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.
Package mcp exposes waiverwatch as MCP tools.
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