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

Dual API Architecture

ChirpIQX integrates two complementary data sources for comprehensive analysis:

Yahoo Fantasy API

Real-time fantasy league data:

• Team rosters and lineups
• Player statistics and availability
• League standings and transactions
• Transaction history
• Injury reports
• Trending players and waiver wire

NHL Edge API

Advanced schedule intelligence:

• Games-per-week calculations
• Team schedule density analysis
• Back-to-back game detection
• Rest advantage identification
• Schedule-aware waiver recommendations

Real-Time Data Tools

Combined API integration for live intelligence:

• Team rosters with schedule context
• Player statistics with games-in-hand analysis
• League standings and competitive positioning
• Transaction history and market trends
• Injury reports with schedule impact

Analytics Tools

Advanced processing combining both API sources:

• Breakout Detection - ML algorithms identifying trends (Yahoo stats + NHL schedule context)
• Roster Optimization - Strategic lineup recommendations with games-in-hand awareness
• Trade Analysis - Fair value calculations incorporating schedule strength
• Trend Detection - Statistical significance analysis with schedule weighting
• Schedule Advantage - NHL Edge API-powered games-per-week 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 (schedule-aware)

// Evening analysis (leverages NHL Edge API)
4. get_trending_players() // Find hot streaks
5. analyze_breakout_players() // Identify pickups
6. get_games_in_hand() // Check schedule advantages
7. get_waiver_wire() // Plan claims with games-per-week context

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.