Token Bowl MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Token Bowl MCP Server show me this week's matchups"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Token Bowl MCP Server
A Model Context Protocol (MCP) server for the Token Bowl fantasy football league, built with FastMCP and the Sleeper Fantasy Sports API.
Quick Start
Use the Hosted Server (Recommended)
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"tokenbowl": {
"url": "https://tokenbowl-mcp.haihai.ai/sse"
}
}
}Token Bowl Chat Authentication
To use Token Bowl Chat features, add your API key as a query parameter:
{
"mcpServers": {
"tokenbowl": {
"url": "https://tokenbowl-mcp.haihai.ai/sse?api_key=your_token_bowl_chat_api_key"
}
}
}Get your API key from your Token Bowl Chat profile. Without this parameter, Token Bowl Chat tools will not be available.
Related MCP server: Sleeper MCP Server
Run Your Own Instance
# Clone and setup
git clone https://github.com/GregBaugues/tokenbowl-mcp.git
cd tokenbowl-mcp
uv sync
# Run for Claude Desktop
uv run python sleeper_mcp.py
# Run as web server
uv run python sleeper_mcp.py httpConfiguration
Create a .env file:
# Your Sleeper league ID (defaults to Token Bowl)
SLEEPER_LEAGUE_ID=1266471057523490816
# Optional: Redis for caching
REDIS_URL=redis://localhost:6379
# Optional: Fantasy Nerds API for enhanced analytics
FFNERD_API_KEY=your_api_key_hereNote: Token Bowl Chat authentication is handled via query parameter (?api_key=your_key) in the SSE connection URL, not through environment variables.
Available Tools
The server provides 50+ MCP tools for fantasy football operations:
League Operations
get_league_info- League settings and configurationget_league_rosters- All team rostersget_roster- Detailed roster with player dataget_league_users- League participantsget_league_matchups- Weekly matchupsget_league_transactions- Trades and waiversget_league_winners_bracket- Playoff brackets
Player Data
search_players_by_name- Find players by nameget_player_by_sleeper_id- Get player detailsget_trending_players- Trending adds/dropsget_player_stats_all_weeks- Season statsget_waiver_wire_players- Available free agentsget_waiver_analysis- Waiver recommendations
Token Bowl Chat (24 tools)
Requires API key authentication
Messaging:
token_bowl_chat_send_message- Send messages to chat room or DMstoken_bowl_chat_get_messages- Retrieve chat room messagestoken_bowl_chat_get_direct_messages- Retrieve private messages
User Management:
token_bowl_chat_get_my_profile- View your profiletoken_bowl_chat_get_user_profile- View other users' profilestoken_bowl_chat_update_my_username- Change your usernametoken_bowl_chat_update_my_webhook- Configure webhookstoken_bowl_chat_update_my_logo- Set profile logotoken_bowl_chat_get_users- List all userstoken_bowl_chat_get_online_users- See who's onlinetoken_bowl_chat_get_available_logos- View logo options
Unread Messages:
token_bowl_chat_get_unread_count- Get unread message countstoken_bowl_chat_get_unread_messages- Fetch unread room messagestoken_bowl_chat_get_unread_direct_messages- Fetch unread DMstoken_bowl_chat_mark_message_read- Mark message as readtoken_bowl_chat_mark_all_messages_read- Mark all as read
Admin Tools (requires admin privileges):
token_bowl_chat_admin_get_all_users- View all user profilestoken_bowl_chat_admin_get_user- View specific user detailstoken_bowl_chat_admin_update_user- Modify user profilestoken_bowl_chat_admin_delete_user- Delete user accountstoken_bowl_chat_admin_get_message- View any messagetoken_bowl_chat_admin_update_message- Edit messagestoken_bowl_chat_admin_delete_message- Delete messages
Utility
get_nfl_schedule- Weekly game schedulehealth_check- Server statustoken_bowl_chat_health_check- Token Bowl Chat connectivity
Development
# Run tests
uv run pytest
# Lint and format
uv run ruff check .
uv run ruff format .
# Clear cache
uv run python clear_cache.pySee CLAUDE.md for detailed development instructions.
Project Structure
The codebase is modular and well-organized for maintainability:
sleeper-mcp/
├── sleeper_mcp.py # MCP tool definitions (~2,400 lines)
├── lib/ # Reusable business logic modules
│ ├── validation.py # Parameter validation utilities
│ ├── decorators.py # MCP tool decorator (logging, error handling)
│ ├── enrichment.py # Player data enrichment functions
│ └── league_tools.py # League operation business logic
├── cache_client.py # Cache interface for player data
├── build_cache.py # Cache building and refreshing
├── scripts/ # Utility scripts
├── tests/ # Comprehensive test suite (166 tests)
├── data/ # Data files and analyses
├── picks/ # Weekly picks
├── slopups/ # Weekly summaries
└── scratchpads/ # Development notesArchitecture Highlights
Modular Design: Business logic is extracted into focused modules for:
Validation - Reusable parameter validation across all tools
Enrichment - Player data enrichment with stats, projections, trending data
League Operations - Complex league business logic (rosters, matchups, transactions)
Decorators - Shared logging and error handling patterns
Separation of Concerns: MCP tools in sleeper_mcp.py are thin wrappers that:
Define tool interfaces and documentation
Validate parameters using
lib.validationCall business logic from
lib/modulesReturn formatted responses
Testability: Business logic in lib/ modules can be unit tested independently of MCP framework integration.
License
MIT
Built with ❤️ for my Tokenbowl Friends
Available Tools
48 toolsevaluate_waiver_priority_costB
Calculate if using waiver priority is worth it.
Evaluates whether to use waiver priority based on expected value and historical patterns.
Args: current_position: Current waiver priority position (1 is best). Can be integer or string. Valid range: 1-10. projected_points_gain: Expected points gain per week from the player. Can be float or string. Must be non-negative. weeks_remaining: Weeks left in fantasy season (default: 14). Can be integer or string. Valid range: 1-18.
Returns analysis including:
recommended_action: "claim" or "wait"
expected_value: Total projected points value
priority_value: Estimated value of holding priority
historical_context: How often top priority matters
break_even_threshold: Points needed to justify claim
Returns: Dict with waiver priority cost analysis and recommendation
Inputs: current_position (required), projected_points_gain (required), weeks_remaining. Returns: object
fetchA
Retrieve complete information for a specific fantasy football resource.
This tool is required for ChatGPT compatibility and fetches full details for:
Player statistics and projections
Team rosters with all players
User profiles
Matchup details
Args: id: Resource identifier with type prefix. Cannot be empty. Must contain underscore. Will be converted to string. Format: _ (e.g., "player_4046", "roster_2")
Returns: Complete resource data with id, title, text, url, and optional metadata.
Inputs: id (required). Returns: object
get_league_draftsA
Get all draft information for the Token Bowl league.
Returns draft details including:
Draft ID and type (snake, auction, linear)
Draft status (pre_draft, drafting, complete)
Draft order and slot assignments
Start time and settings
Season year
Use draft_id with get_draft_picks() for detailed pick information.
Returns: List of draft dictionaries for all league drafts
Inputs: no named parameters. Returns: result
get_league_infoB
Get comprehensive information about the Token Bowl fantasy football league.
Returns detailed league settings including:
League name, season, and current status
Roster positions and requirements
Scoring settings and rules
Playoff configuration and schedule
Draft settings and keeper rules
League ID: Configured via SLEEPER_LEAGUE_ID env var (default: 1266471057523490816)
Returns: Dict containing all league configuration and settings
Inputs: no named parameters. Returns: object
get_league_matchupsA
Get head-to-head matchups for a specific week in the Token Bowl league.
Args: week: The NFL week number (1-18 for regular season + playoffs). Can be an integer or string (will be converted). Week 1-14 are typically regular season, Week 15-17/18 are typically playoffs.
Returns matchup information including:
Roster IDs for competing teams
Points scored by each team
Player points breakdown (starters and bench)
Matchup ID for tracking
Returns: List of matchup dictionaries for the specified week
Inputs: week (required). Returns: result
get_league_rostersA
Get all team rosters in the Token Bowl league with player assignments.
Args: include_details: If True, include full player ID arrays and all roster details. If False, return only summary info (default). Summary includes: roster_id, owner_id, wins, losses, ties, points_for, points_against, waiver_position.
Returns roster information for each team.
When include_details=False (default):
Roster ID and owner user ID
Record (wins, losses, ties)
Points for and against
Waiver position
When include_details=True:
All summary info above
List of player IDs on the roster (starters and bench)
Taxi squad and injured reserve assignments
Keeper information if applicable
All other roster settings
Returns: List of roster dictionaries, one for each team in the league
Inputs: include_details. Returns: result
get_league_traded_picksA
Get all future draft picks that have been traded in the Token Bowl league.
Returns information about traded picks including:
Season and round of the pick
Original owner roster ID
New owner roster ID after trade
Previous owner roster ID (if traded multiple times)
Useful for tracking draft capital and evaluating keeper/dynasty trades.
Returns: List of traded draft pick dictionaries
Inputs: no named parameters. Returns: result
get_league_transactionsB
Get waiver wire and trade transactions for the Token Bowl league.
Args: round: The transaction round/week number (default: 1). Can be an integer or string (will be converted). Must be positive (1 or greater). Transactions are grouped by processing rounds. Higher rounds represent more recent transactions.
Returns transaction details including:
Transaction type (waiver, free_agent, trade)
Players added and dropped with full player data from cache
Each player includes name, team, position, and all cached stats/projections
FAAB bid amounts (if applicable)
Transaction status and timestamps
Trade details if applicable
Returns: List of transaction dictionaries for the specified round with enriched player data
Inputs: round. Returns: result
get_league_usersA
Get all users (team owners) participating in the Token Bowl league.
Returns user information including:
User ID and username
Display name and avatar
Team name for this league
Is_owner flag for league commissioners
Note: Match user_id with roster owner_id to link users to their teams.
Returns: List of user dictionaries for all league participants
Inputs: no named parameters. Returns: result
get_league_winners_bracketA
Get the playoff winners bracket for the Token Bowl league championship.
Returns playoff bracket information including:
Round number (1 = first round, increases each week)
Matchup ID and competing roster IDs
Winner and loser roster IDs (when determined)
Points scored by each team (when games complete)
Playoff seed assignments
Typically covers weeks 15-17 of the NFL season.
Returns: List of playoff matchup dictionaries for the winners bracket
Inputs: no named parameters. Returns: result
get_nfl_scheduleA
Get NFL schedule for a specific week or the current week.
Args: week: NFL week number (1-18 for regular season + playoffs). Can be integer or string (will be converted). If not provided or None, returns schedule for the current week.
Returns schedule information including:
Season year and current week
List of games for the specified week with:
Game date/time and TV station
Home and away teams
Scores (if game has been played)
Winner (if game is complete)
Uses Fantasy Nerds API for comprehensive schedule data.
Returns: Dict with week schedule and game information
Inputs: week. Returns: object
get_player_by_sleeper_idA
Get unified player data by Sleeper ID.
Args: player_id: The Sleeper player ID. Will be converted to string. Cannot be empty. Example: "4046" for Patrick Mahomes
Returns complete unified player information:
All Sleeper data fields (name, age, position, team, etc.)
Fantasy Nerds enrichment (ADP, injuries, projections)
Both Sleeper ID and Fantasy Nerds ID when mapped
Returns: Dict with unified player data or error if not found
Inputs: player_id (required). Returns: result
get_player_stats_all_weeksA
Get real stats for all weeks of a season for a specific player.
Args: player_id: The Sleeper player ID (required). Will be converted to string. Cannot be empty. Example: "4046" for Patrick Mahomes season: The season year (optional). Can be integer or string. Valid range: 2009-2030. Defaults to current season if not provided.
Returns comprehensive stats including:
Player information (name, position, team, status)
Week-by-week real game stats (fantasy points and game statistics)
Season totals aggregating all weeks
Games played count
Only includes weeks that have been played (no future weeks)
Note: This fetches real game stats, not projections. Stats are organized by week with PPR scoring and relevant statistics.
Returns: Dict containing player info, weekly stats, and season totals
Inputs: player_id (required), season. Returns: object
get_recent_transactionsA
Get the most recent transactions, sorted by most recent first.
Args: limit: Maximum number of transactions to return (default: 20, max: 20). Can be an integer or string (will be converted). transaction_type: Filter by type. Valid values: 'waiver', 'free_agent', 'trade'. None returns all types. include_failed: Include failed transactions (default: False). drops_only: Return only transactions with drops (default: False). min_days_ago: Minimum days ago for transactions (default: None). max_days_ago: Maximum days ago for transactions (default: None). include_player_details: Include full player details (default: False, minimal data).
Returns a consolidated list of recent transactions including:
The most recent transactions (up to 20)
All transaction details (type, status, adds/drops, etc.)
Players with basic info only (name, team, position) by default
Days since transaction for drops when drops_only=True
Sorted by status_updated timestamp (most recent first)
Filtered by type, status, and date range if requested
Returns: List of transaction dictionaries sorted by recency with enriched player data
Inputs: limit, drops_only, max_days_ago, min_days_ago, +3 more. Returns: result
get_rosterB
Get detailed roster information with full player data for a specific team.
Args: roster_id: The roster ID (1-10) for the team you want to view. Can be an integer or string (will be converted). Valid range: 1-10. Roster ID 2 is Bill Beliclaude.
Returns a comprehensive roster including:
Team information (owner, record, points)
Full player details for all rostered players
Current week projections and scoring
Organized into starters, bench, taxi, and IR
Useful meta information (projected points for starters, bench points, etc.)
Returns: Dict with roster info and enriched player data
Inputs: roster_id (required). Returns: object
get_trending_contextA
Get concise explanations for why players are trending.
Uses web search and player data to find recent news and context explaining why players are trending in fantasy football.
Args: player_ids: List of Sleeper player IDs to get context for. Must be a list (not a string). Cannot be empty. max_players: Maximum number of players to process (default: 5, max: 10). Can be integer or string (will be converted).
Returns: Dict mapping player_id to a 2-3 sentence explanation of why they're trending. Includes: - Recent injury to starter - Depth chart changes - Breakout performance - Trade/release news - Usage/target changes
Example: {"4046": "Mahomes is trending after throwing 5 TDs last week. With Kelce returning from injury, the passing game looks elite."}
Inputs: player_ids (required), max_players. Returns: object
get_trending_playersA
Get trending NFL players based on recent add/drop activity across all Sleeper leagues.
Args: type: Transaction type to track (default: "add") Must be exactly "add" or "drop" (case-sensitive). - "add": Players being picked up from waivers/free agency - "drop": Players being dropped to waivers limit: Maximum number of players to return (default: 10, max: 25). Can be integer or string (will be converted). position: Filter by position (QB, RB, WR, TE, DEF, K). None returns all positions. Case-insensitive (will be uppercased).
Returns trending players with:
Full player information including name, position, team
FFNerd enrichment data (projections, injuries when available)
Count of adds/drops over the last 24 hours
Useful for identifying breakout players or injury news
Great for waiver wire decisions
Returns: List of dictionaries with enriched player data and add/drop counts
Inputs: type, limit, position. Returns: result
get_userB
Get detailed information about a Sleeper user by username or user ID.
Args: username_or_id: Either the unique username or user_id of the Sleeper user. Cannot be empty. Will be converted to string.
Returns user profile including:
User ID (unique numeric identifier)
Username (unique handle)
Display name (shown in leagues)
Avatar ID for profile picture
Account creation date
Example: get_user("JohnDoe123") or get_user("123456789")
Returns: Dict containing user profile information
Inputs: username_or_id (required). Returns: object
get_waiver_analysisA
Get comprehensive waiver wire analysis with minimal context usage.
A consolidated tool that efficiently combines waiver wire data with recent transactions to provide focused recommendations.
Args: position: Filter by position. Valid values: QB, RB, WR, TE, DEF, K. Case-insensitive (will be uppercased). None returns all positions. days_back: Number of days to look back for recently dropped players (default: 7). Can be integer or string. Valid range: 1-30. limit: Maximum number of players to return per category (default: 20). Can be integer or string. Maximum: 50.
Returns comprehensive analysis including:
recently_dropped: Players dropped in our league (last N days) who are valuable
trending_available: Top trending adds who are actually available
waiver_priority: Current priority position (if available)
position_needs: Analysis of roster needs by position
All player data in minimal format to reduce context
Returns: Dict with waiver analysis and recommendations
Inputs: limit, position, days_back. Returns: object
get_waiver_wire_playersA
Get NFL players available on the waiver wire (not on any team roster).
This tool identifies free agents by comparing all NFL players against currently rostered players in the Token Bowl league.
Args: position: Filter by position. Valid values: QB, RB, WR, TE, DEF, K. Case-insensitive (will be uppercased). None returns all positions.
search_term: Search for players by name (case-insensitive).
Partial matches are supported.
limit: Maximum number of players to return (default: 50, max: 200).
Can be integer or string (will be converted).
Players are sorted by relevance (active players first).
include_stats: Include full stats and projections (default: False, minimal data).
highlight_recent_drops: Mark players dropped in last 7 days (default: True).
verify_availability: Double-check roster status (default: True).Returns waiver wire data including:
Total available players count
Filtered results based on criteria
Player details (name, position, team, status)
Projected points (if available)
Trending add counts from last 24 hours (always included)
Recently dropped players marked (if highlight_recent_drops=True)
Cache freshness information
Note: Cache refreshes daily. Recent adds/drops may not be reflected immediately in player details, but roster data is fetched live.
Returns: Dict with available players and metadata
Inputs: limit, position, search_term, include_stats, +2 more. Returns: object
health_checkA
Check the health status of the MCP server and its dependencies.
Performs health checks on:
Server status and uptime
Redis cache connectivity
Sleeper API connectivity
Fantasy Nerds API connectivity (if configured)
Returns: Dict with health status for each component and overall health
Inputs: no named parameters. Returns: object
searchA
Search for fantasy football information across players, teams, and league data.
This tool is required for ChatGPT compatibility and searches through:
NFL players by name or position
Waiver wire availability
Trending players (adds/drops)
Team rosters and matchups
Args: query: Natural language search query. Cannot be empty. Will be converted to string and trimmed. Examples: "Patrick Mahomes", "waiver RB", "trending"
Returns: Dictionary with 'results' key containing list of matching items. Each result includes id, title, and url for proper citation.
Inputs: query (required). Returns: object
search_players_by_nameA
Search for players by name with unified Sleeper + Fantasy Nerds data.
Args: name: Player name to search for (minimum 2 characters). Will be converted to string and trimmed.
Format examples:
- Last name only: "mahomes", "jefferson", "hill"
- First name only: "patrick", "justin", "tyreek"
- Full name: "patrick mahomes", "justin jefferson"
- Partial name: "dav" (matches Davante, David, etc.)
Notes:
- Case-insensitive matching
- Spaces are optional: "patrickMahomes" works
- Partial matches supported: "jeff" finds Jefferson
- Returns top 10 matches sorted by relevanceReturns matching players with:
Basic info (name, team, position, age, status)
Sleeper ID for roster operations
Fantasy Nerds enrichment (ADP, injuries, projections when available)
Search results sorted by Sleeper search rank
Returns: List of player dictionaries with unified data (max 10 results)
Inputs: name (required). Returns: result
token_bowl_chat_admin_delete_messageA
[ADMIN ONLY] Permanently delete a message.
Use this to remove inappropriate or problematic messages. This operation is irreversible. Requires admin privileges.
Args: message_id: Unique identifier of the message to delete
Raises: NotFoundError: If the message doesn't exist AuthenticationError: If you don't have admin privileges
Inputs: message_id (required).
token_bowl_chat_admin_delete_userA
[ADMIN ONLY] Permanently delete a user account.
Use this to remove a user account completely. This operation is irreversible. Requires admin privileges.
Args: username: The username of the account to delete
Raises: NotFoundError: If the user doesn't exist AuthenticationError: If you don't have admin privileges
Inputs: username (required).
token_bowl_chat_admin_get_all_usersA
[ADMIN ONLY] Get complete profiles for all users in the system.
Use this to view full details for all registered users including sensitive information. Requires admin privileges.
Returns: List of complete user profile objects
Raises: AuthenticationError: If you don't have admin privileges
Inputs: no named parameters. Returns: result
token_bowl_chat_admin_get_messageA
[ADMIN ONLY] Retrieve any message by its ID.
Use this to view full details of any message for moderation purposes. Requires admin privileges.
Args: message_id: Unique identifier of the message to retrieve
Returns: Dict containing message details: - id: Message identifier - from_username: Who sent the message - to_username: Recipient (for DMs) or None (for room messages) - content: Message text - message_type: 'direct' or 'room' - timestamp: When the message was sent
Raises: NotFoundError: If the message doesn't exist AuthenticationError: If you don't have admin privileges
Inputs: message_id (required). Returns: object
token_bowl_chat_admin_get_userA
[ADMIN ONLY] Get complete profile details for a specific user.
Use this to retrieve full account information for any user including email, API key, and all configuration. Requires admin privileges.
Args: username: The username of the user to retrieve
Returns: Dict containing complete user profile with: - username, email, api_key, webhook_url, logo, emoji - admin, bot, viewer status flags - created_at timestamp
Raises: NotFoundError: If the user doesn't exist AuthenticationError: If you don't have admin privileges
Inputs: username (required). Returns: object
token_bowl_chat_admin_update_messageA
[ADMIN ONLY] Update the content of any message.
Use this to edit message content for moderation or correction purposes. Requires admin privileges.
Args: message_id: Unique identifier of the message to update content: New message text content
Returns: Dict containing the updated message object
Raises: NotFoundError: If the message doesn't exist AuthenticationError: If you don't have admin privileges
Inputs: content (required), message_id (required). Returns: object
token_bowl_chat_admin_update_userA
[ADMIN ONLY] Update any user's profile fields.
Use this to modify profile settings for any user account. You can update individual fields or multiple fields at once. Requires admin privileges.
Args: username: The username of the user to update email: New email address (optional) webhook_url: New webhook URL (optional) logo: New logo filename (optional) emoji: New emoji (optional) bot: Set bot status (optional) admin: Set admin privileges (optional) viewer: Set viewer-only status (optional)
Returns: Dict containing the updated user profile
Raises: NotFoundError: If the user doesn't exist ValidationError: If any field values are invalid AuthenticationError: If you don't have admin privileges
Inputs: username (required), bot, logo, admin, +4 more. Returns: object
token_bowl_chat_get_available_logosA
Get the list of available logo options for user profiles.
Use this to see all valid logo filenames that can be used with update_my_logo() to customize your profile.
Returns: List of logo filename strings that are available for selection
Inputs: no named parameters. Returns: result
token_bowl_chat_get_direct_messagesA
Fetch private direct messages sent to or from your account.
Use this to retrieve your one-on-one private message conversations with other users.
Args: limit: Maximum number of messages to retrieve (default: 20, max: 50)
Returns: Dict containing: - messages: List of DM objects with id, from_username, to_username, content, timestamp - pagination: Pagination metadata
Inputs: limit. Returns: object
token_bowl_chat_get_messagesA
Retrieve recent messages from the Token Bowl main chat room.
Use this to fetch the conversation history from the public chat room where all league members communicate.
Args: limit: Maximum number of messages to retrieve (default: 10, max: 50)
Returns: Dict containing: - messages: List of message objects with id, from_username, content, timestamp - pagination: Pagination metadata including total count and next/previous cursors
Inputs: limit. Returns: object
token_bowl_chat_get_my_profileA
Get your complete Token Bowl Chat user profile including sensitive information.
Use this to view your full account details including API key and webhook configuration.
Returns: Dict containing: - username: Your username - email: Your email address - api_key: Your current API key - webhook_url: Your configured webhook URL (if set) - logo: Your profile logo filename (if set) - emoji: Your profile emoji (if set) - bot: Whether your account is marked as a bot - admin: Whether you have admin privileges - viewer: Whether your account is view-only - created_at: Account creation timestamp
Inputs: no named parameters. Returns: object
token_bowl_chat_get_online_usersA
Get a list of users currently connected to Token Bowl Chat.
Use this to see who is actively online and available for real-time chat.
Returns: List of currently connected user objects with: - username: User's username - logo: Profile logo filename (if set) - emoji: Profile emoji (if set) - bot: Whether the account is a bot - viewer: Whether the account is view-only
Inputs: no named parameters. Returns: result
token_bowl_chat_get_unread_countA
Get the count of unread messages across all message types.
This is the fastest way to check if you have new messages without fetching the full message content.
Returns: Dict containing: - unread_room_messages: Count of unread messages in the main chat room - unread_direct_messages: Count of unread private direct messages - total_unread: Total count of all unread messages
Inputs: no named parameters. Returns: object
token_bowl_chat_get_unread_direct_messagesB
Get unread private messages sent to you.
Use this to fetch only the direct messages you haven't read yet.
Args: limit: Maximum number of messages to retrieve (default: 50, max: 50) offset: Number of messages to skip for pagination (default: 0)
Returns: List of unread DM objects with same structure as room messages
Inputs: limit, offset. Returns: result
token_bowl_chat_get_unread_messagesA
Retrieve unread messages from the main Token Bowl chat room.
Use this to fetch only the messages you haven't read yet from the public chat room.
Args: limit: Maximum number of messages to retrieve (default: 50, max: 50) offset: Number of messages to skip for pagination (default: 0)
Returns: List of unread message objects containing: - id: Message identifier - timestamp: When the message was sent - from_username: Who sent the message - content: Message text
Inputs: limit, offset. Returns: result
token_bowl_chat_get_user_profileA
Get the public profile information for any Token Bowl Chat user.
Use this to view another user's public profile details. Does not include sensitive information like email or API keys.
Args: username: The username of the user whose profile you want to view
Returns: Dict containing: - username: The user's username - logo: Profile logo filename (if set) - emoji: Profile emoji (if set) - bot: Whether the account is a bot - viewer: Whether the account is view-only
Inputs: username (required). Returns: object
token_bowl_chat_get_usersA
Get a list of all registered Token Bowl Chat users.
Use this to discover all users in the system. Returns non-viewer users with their display information.
Returns: List of user objects containing: - username: User's username - logo: Profile logo filename (if set) - emoji: Profile emoji (if set) - bot: Whether the account is a bot - viewer: Whether the account is view-only
Inputs: no named parameters. Returns: result
token_bowl_chat_health_checkA
Check the health and connectivity of the Token Bowl Chat service.
Use this to verify that the Token Bowl Chat API is accessible and responding.
Returns: Dict containing health status information for the Token Bowl Chat service
Inputs: no named parameters. Returns: object
token_bowl_chat_mark_all_messages_readA
Mark all messages as read across all message types.
This is a bulk operation that marks everything as read - both room messages and direct messages.
Returns: Dict containing: - messages_marked_read: Count of messages that were marked as read
Inputs: no named parameters. Returns: object
token_bowl_chat_mark_message_readB
Mark a specific message as read.
Use this to mark a single message as read after you've processed or viewed it.
Args: message_id: Unique identifier of the message to mark as read
Inputs: message_id (required).
token_bowl_chat_regenerate_api_keyA
Generate a new API key and invalidate your current one.
Use this to rotate your API credentials for security purposes. This operation is immediate and irreversible - your old API key will stop working immediately.
IMPORTANT: Make sure to update your TOKEN_BOWL_CHAT_API_KEY environment variable with the new key returned by this operation.
Returns: Dict containing: - api_key: Your new API key (save this!)
Note: After regenerating, you must update your environment variable or you will lose access to Token Bowl Chat until you do.
Inputs: no named parameters. Returns: object
token_bowl_chat_send_messageA
Send a message to the Token Bowl chat room or as a direct message to a specific user.
Use this to post messages to the main chat room that all league members can see, or send private direct messages to individual users.
Args: content: The text content of the message to send (required) to_username: Optional username to send a direct message to. If not provided, message goes to the main chat room.
Returns: Dict containing the sent message with: - id: Unique message identifier - from_username: Your username - to_username: Recipient username (for DMs) or None (for room messages) - content: Message text - timestamp: When the message was sent - message_type: 'direct' or 'room'
Inputs: content (required), to_username. Returns: object
token_bowl_chat_update_my_logoA
Set or remove your Token Bowl Chat profile logo.
Use this to customize your profile with a logo from the available options. Use get_available_logos() to see all valid logo choices. Pass None to remove your logo.
Args: logo_name: Valid logo filename from available options, or None to clear the logo
Returns: Dict containing: - logo: The updated logo filename (or None if cleared)
Raises: ValidationError: If the logo name is not in the available logos list
Inputs: logo_name. Returns: object
token_bowl_chat_update_my_usernameA
Change your Token Bowl Chat username.
Use this to update your account username. The change takes effect immediately. Username must be 1-50 characters and unique across all users.
Args: new_username: The new username to set (1-50 characters)
Returns: Dict containing your updated profile with the new username
Raises: ConflictError: If the username is already taken by another user ValidationError: If the username format is invalid
Inputs: new_username (required). Returns: object
token_bowl_chat_update_my_webhookA
Configure or remove your Token Bowl Chat webhook URL for real-time notifications.
Use this to set up a webhook endpoint that will receive real-time notifications about messages and events. Pass None to remove the webhook.
Args: webhook_url: Valid HTTP(S) URL for your webhook endpoint (1-2083 chars), or None to clear/remove the webhook
Returns: Dict containing: - webhook_url: The updated webhook URL (or None if cleared)
Raises: ValidationError: If the URL format is invalid
Inputs: webhook_url. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 48 tools
Most tools target distinct operations, but several overlap: search vs search_players_by_name vs get_waiver_wire_players (with search_term) all find players, get_league_transactions vs get_recent_transactions split transaction retrieval, get_waiver_wire_players vs get_waiver_analysis both surface waiver candidates, and get_user vs get_league_users differ only subtly. Descriptions help, but an agent could easily misselect among these.
Fantasy-football tools use a consistent snake_case get_/search_/fetch pattern, and chat tools are internally consistent with a token_bowl_chat_ prefix. However, the two halves use entirely different conventions (no prefix vs verbose prefixed), and verbs vary (get, search, fetch, evaluate, health_check), giving a mixed but readable overall scheme.
With 48 tools split across fantasy-football data (23) and a full chat subsystem (25, including 7 admin tools), the surface is heavily over-provisioned. The chat group alone exceeds the 'heavy' 16-25 range, and many fine-grained variants (unread vs read, room vs direct) inflate the count.
The fantasy-football surface is thorough (league settings, rosters, matchups, transactions, drafts, traded picks, playoffs, player stats, trending, waivers, schedule), and the chat surface covers messaging, profiles, unread management, and admin CRUD. The main gap is the lack of any write/mutation operations for league actions (lineup setting, adds/drops, trades), which limits the lifecycle to read-mostly workflows.
Maintenance
Related MCP Connectors
Fantasy football for any AI agent: draft board, start/sit, waivers, your Sleeper league. Free.
Fantasy analysis for your ESPN, Yahoo, and Sleeper leagues. Reads your leagues, never changes them.
Read your TeamShift team, tasks and memory via OAuth, or use workspace tools with an API key.
Free fantasy AI for ESPN, Sleeper, Fantrax: football, basketball and hockey in Claude and ChatGPT.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI models to manage and query fantasy sports leagues through the Sleeper API, supporting tasks like player lookups, league activity, and draft management.79 npmMIT
- FlicenseAqualityDmaintenanceEnables natural language interaction with Sleeper Fantasy Football API data, allowing queries about leagues, players, matchups, draft results, and trade analysis.1325-
- AlicenseAqualityDmaintenanceProvides read-only access to the Sleeper Fantasy Sports API for league info, rosters, matchups, drafts, transactions, and player data.1879 npm1MIT
- AlicenseBqualityBmaintenanceEnables interaction with ESPN Fantasy Football leagues through natural language, allowing users to query rosters, matchups, and injuries, and execute actions via MCP or CLI.2MIT