ChirpIQX

Appearance

Getting Started ​

Get up and running with Semantic Chirp Intelligence MCP in minutes.

Prerequisites ​

Before you begin, ensure you have:

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

Installation ​

1. Clone the Repository ​

bash
git clone https://github.com/semanticintent/semantic-chirp-intelligence-mcp.git
cd semantic-chirp-intelligence-mcp

2. Install Dependencies ​

bash
npm install

3. Yahoo Fantasy API Setup ​

Get Your Yahoo 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

Configure Environment ​

bash
# Copy example environment file
cp .env.example .env

# Edit .env with your credentials

Your .env file should look like:

env
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

Finding Your League and Team IDs

  • League ID: Check your Yahoo Fantasy league URL
  • Team ID: Found in your team's URL on Yahoo Fantasy

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

Support ​

Having issues?

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