MCP Tools Overview

ChirpIQX provides a comprehensive suite of Model Context Protocol tools for fantasy hockey dominance.

Available Tools

🏒 Team Management

Tool	Description	Use Case
get_team_roster	Retrieve your complete roster with current stats	Daily lineup review
get_league_standings	View league rankings and records	Track competition
get_team_matchup	Analyze current week's matchup	Optimize weekly lineup

Learn More →

📊 Player Analysis

Tool	Description	Use Case
search_players	Find players by name or criteria	Waiver wire research
get_player_stats	Detailed statistics for any player	Trade evaluation
get_trending_players	See who's hot right now	Find breakouts early
analyze_breakout_players	Advanced ML detection of emerging talent	Waiver wire edge

Learn More →

🎯 Roster Optimization

Tool	Description	Use Case
ice	Intent Chirp Engine - Strategic AI analysis	Critical decisions
optimize_lineup	AI-powered daily lineup suggestions	Maximize points
trade_analyzer	Fair value assessment	Win trades

Learn More →

📈 League Intelligence

Tool	Description	Use Case
get_waiver_wire	Available free agents	Pickup planning
get_league_transactions	Recent adds/drops	Track league trends
get_injury_report	League-wide injury updates	Stay informed

Learn More →

Tool Categories

Real-Time Data Tools

Direct Yahoo Fantasy API integration for live data:

• Team rosters and lineups
• Player statistics and availability
• League standings and schedules
• Transaction history
• Injury reports

Analytics Tools

Advanced processing and insights:

• Breakout Detection - ML algorithms identifying trends
• Roster Optimization - Strategic lineup recommendations
• Trade Analysis - Fair value calculations
• Trend Detection - Statistical significance analysis

Decision Support Tools

Strategic tools for critical moments:

• ICE (Intent Chirp Engine) - AI-powered strategic analysis with chirp intelligence
• Waiver Wire Recommendations - Prioritized pickup lists
• Matchup Analysis - Weekly strategy optimization
• Trade Proposals - Fair deal suggestions

Common Workflows

Daily Routine

// Morning check
1. get_team_roster() // Review your team
2. get_injury_report() // Check for news
3. optimize_lineup() // Set daily lineup

// Evening analysis
4. get_trending_players() // Find hot streaks
5. analyze_breakout_players() // Identify pickups
6. get_waiver_wire() // Plan claims

Trade Analysis

1. get_player_stats(player_a) // Your player
2. get_player_stats(player_b) // Their player
3. trade_analyzer({offer: [a], receive: [b]})
4. // Make informed decision

Waiver Wire Strategy

1. analyze_breakout_players() // ML detection
2. get_trending_players() // Hot streaks
3. get_waiver_wire() // Available players
4. // Cross-reference for pickups

Using Tools in Claude

Natural Language Queries

Just ask Claude naturally:

"Who should I pick up from waivers this week?"
"How's my team doing in the standings?"
"Is this trade fair?" [describe trade]
"Who's breaking out that I can pick up?"

Semantic Intent Recognition

The MCP server understands:

• Roster questions → get_team_roster
• Player research → search_players, get_player_stats
• Waiver strategy → analyze_breakout_players, get_waiver_wire
• Trade evaluation → trade_analyzer
• League status → get_league_standings

Context Awareness

Tools remember your league context:

• Configured league ID
• Your team ID
• Scoring categories
• Recent queries

Tool Response Format

Each tool returns structured data:

{
  "success": true,
  "data": {
    // Tool-specific results
  },
  "metadata": {
    "timestamp": "2025-01-15T12:00:00Z",
    "league_id": "12345",
    "source": "yahoo_fantasy_api"
  }
}

Rate Limits & Caching

Yahoo API Limits

• Rate limit: ~10,000 requests/day
• Burst limit: ~100 requests/minute
• Cache strategy: 5-minute default for most data

Best Practices

1. Batch requests when possible
2. Cache responses for repeated queries
3. Use trending data sparingly (counts against limits)
4. Schedule intensive analysis during off-peak

Error Handling

Tools return helpful error messages:

// Authentication error
{ error: "Yahoo OAuth token expired. Run: node authenticate.js" }

// Rate limit
{ error: "API rate limit reached. Try again in 5 minutes." }

// Player not found
{ error: "Player 'Connor McDavid' not found in available pool" }

Next Steps

• Team Management Tools - Manage your roster
• Player Analysis Tools - Research players
• Roster Optimization - Win more games
• API Reference - Technical details

---

Pro Tip: Combine multiple tools for comprehensive analysis. Example: Use analyze_breakout_players + get_waiver_wire to find the best available pickups with trending stats.