ChirpIQX

Appearance

Getting Started ​

Get started with Semantic Chirp Intelligence MCP for fantasy hockey dominance.

Note: ChirpIQX is available as a custom MCP integration. This guide provides technical reference for the architecture and setup process. For custom deployment inquiries, see the contact information below.

Architecture Overview ​

ChirpIQX integrates dual APIs for comprehensive fantasy hockey intelligence:

  • Yahoo Fantasy API - Player stats, roster management, league data
  • NHL Edge API - Advanced schedule analysis, games-in-hand calculations

System Prerequisites ​

The reference implementation requires:

  • Node.js v20 or higher
  • npm or yarn package manager
  • Claude Desktop (for MCP integration)
  • Yahoo Fantasy Sports account with an active hockey league
  • NHL Edge API access (for schedule intelligence)

Reference Implementation Setup ​

1. Repository Structure ​

bash
# Example repository structure
semantic-chirp-intelligence-mcp/
├── src/
│   ├── analyses/          # 7-layer cognitive architecture
│   ├── services/          # API clients (Yahoo + NHL Edge)
│   └── domain/            # Semantic Intent types

2. Install Dependencies ​

bash
npm install

3. API Configuration ​

Yahoo Fantasy API Setup ​

The system requires Yahoo Fantasy API credentials:

  1. Go to Yahoo Developer Network
  2. Create a new app (or use existing)
  3. Note your Client ID and Client Secret
  4. Set redirect URI to http://localhost:3000/callback

NHL Edge API Setup ​

The system integrates NHL Edge API for schedule intelligence:

  • Purpose: Accurate games-per-week calculations
  • Use case: Schedule-aware waiver recommendations
  • Key feature: Identifies teams with 4-game weeks vs. 2-game weeks

Environment Configuration ​

env
# Yahoo Fantasy API
YAHOO_CLIENT_ID=your_client_id_here
YAHOO_CLIENT_SECRET=your_client_secret_here
LEAGUE_ID=your_league_id_here
TEAM_ID=your_team_id_here

# NHL Edge API
NHL_EDGE_API_KEY=your_nhl_edge_key_here

Finding Your IDs

  • League ID: Check your Yahoo Fantasy league URL
  • Team ID: Found in your team's URL on Yahoo Fantasy
  • NHL Edge API: Contact for integration details

4. Authenticate with Yahoo ​

bash
# Run the authentication script
node authenticate.js

This will:

  1. Open your browser to Yahoo login
  2. Ask you to authorize the app
  3. Save OAuth tokens locally in .yahoo-oauth.json

5. Build the MCP Server ​

bash
npm run build

This compiles TypeScript to JavaScript in the build/ directory.

Claude Desktop Integration ​

Configure Claude Desktop ​

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

json
{
  "mcpServers": {
    "semantic-chirp-intelligence-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/semantic-chirp-intelligence-mcp/build/index.js"
      ],
      "env": {
        "LEAGUE_ID": "your_league_id",
        "TEAM_ID": "your_team_id"
      }
    }
  }
}

Use Absolute Paths

Make sure to use the absolute path to your build/index.js file, not a relative path.

Restart Claude Desktop ​

Close and reopen Claude Desktop to load the MCP server.

Verify Installation ​

In Claude Desktop, try asking:

Show me my fantasy hockey team roster

If everything is configured correctly, you should see your current roster with player stats!

Quick Test ​

Test the MCP server directly:

bash
npm run start

This runs the server in standalone mode for testing.

Next Steps ​

Troubleshooting ​

OAuth Token Issues ​

If you get authentication errors:

bash
# Re-authenticate
rm .yahoo-oauth.json
node authenticate.js

MCP Server Not Loading ​

  1. Check Claude Desktop logs for errors
  2. Verify absolute path in config is correct
  3. Ensure build/index.js exists (run npm run build)
  4. Restart Claude Desktop

API Rate Limits ​

Yahoo Fantasy API has rate limits. If you hit them:

  • Wait a few minutes before retrying
  • Consider caching results locally
  • Use batch requests when possible

Custom Integration Support ​

Interested in ChirpIQX for your fantasy league?

Open Source Alternatives ​

Other open-source MCP implementations available:

  • PerchIQX - Database schema intelligence
  • WakeIQX - AI context temporal intelligence

Ready to dominate your league? Let's go! 🏒