sleeper-mcp

Self-hosted remote MCP for Sleeper fantasy football. Deploy your own Cloudflare Worker. Paste one URL into Grok, Cursor, Claude, or any MCP client.

This repo does not host a public multi-tenant proxy. You run it. You pay your Worker. Sleeper rate limits hit your account, not ours.

No Sleeper login. The public API is read-only. Identity is username + league_id.

Why this exists

Most Sleeper MCPs are local npx / stdio. Grok connectors and most remote harnesses want:

https://sleeper-mcp.<your-account>.workers.dev/mcp

Free agents are computed here (NFL player map minus every rostered ID). Do not recommend a player unless get_free_agents returns them.

Related MCP server: Sleeper Fantasy Football MCP

Tools

Deploy (Cloudflare Workers Builds)

Same path as porkbun-mcp: connect this GitHub repo on the Worker. Cloudflare deploys on push. No GitHub CLOUDFLARE_API_TOKEN.

Workers & Pages → sleeper-mcp → Settings → Build → Connect:

Leave the API token on the default Cloudflare-generated Builds token. Runtime identity stays on Settings → Variables and Secrets as encrypted secrets, not in GitHub and not in [vars]. Empty SLEEPER_USERNAME / SLEEPER_LEAGUE_ID in wrangler.toml overwrite secrets of the same name on deploy. Season is not a Worker var; list_leagues uses Sleeper's current NFL season unless the caller passes season.

First-time KV (already done for merimeesoftware):

npx wrangler kv namespace create sleeper-mcp-cache

Put the returned id in wrangler.toml under kv_namespaces[0].id.

Optional defaults (or pass IDs on every tool call):

npx wrangler secret put SLEEPER_USERNAME
npx wrangler secret put SLEEPER_LEAGUE_ID

League ID is the number in https://sleeper.com/leagues/<id>/....

Manual deploy from a logged-in machine:

npm run deploy

MCP URL:

https://sleeper-mcp.<your-subdomain>.workers.dev/mcp

Connect

Grok: grok.com → Connectors → New → Custom → paste the full /mcp URL, including https://. The field can crop the left side (leeper-mcp...); confirm the stored value is not missing https:// before Add.

Streamable HTTP is POST-only. GET /mcp returns 405 immediately (Allow: POST) so clients that probe SSE do not hang.

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "sleeper": {
      "url": "https://sleeper-mcp.<your-subdomain>.workers.dev/mcp"
    }
  }
}

Grok CLI:

grok mcp add --transport http sleeper https://sleeper-mcp.<your-subdomain>.workers.dev/mcp

Local

npm run dev

Inspector: npx @modelcontextprotocol/inspector@latest → http://localhost:8787/mcp

Limits

• Sleeper: stay under ~1000 req/min. Player dump is cached 24h in KV.

• Read-only. Cannot add, drop, or trade.

• Do not point a public Worker at the world without your own rate limit.

License

MIT