jimbrig/yahoo-fantasy-baseball-mcp

Yahoo Fantasy Baseball MCP Server

This MCP server provides tools to interact with the Yahoo Fantasy Sports API, specifically tailored for fantasy baseball leagues.

Features

• OAuth 1.0a authentication with Yahoo API
• Access to team rosters, player stats, and more
• Integration with Claude via MCP protocol

Getting Started

Prerequisites

• Node.js (v16 or higher)
• Yahoo Developer account with API credentials
• A Yahoo Fantasy Baseball league

Installation

1. Clone this repository:

   git clone <repository-url>
   cd yahoo-fantasy-baseball-MCP
   

2. Install dependencies:

   npm install
   

3. Set up environment variables by creating or updating a .env file:

   YAHOO_CLIENT_ID=your_yahoo_client_id
   YAHOO_CLIENT_SECRET=your_yahoo_client_secret
   YAHOO_ACCESS_TOKEN=your_access_token
   

Obtaining Yahoo API Access

Note: The Yahoo Fantasy Sports API uses OAuth for authentication. The provided token script may need to be updated if the Yahoo API endpoints have changed.

1. Visit the Yahoo Developer Network
2. Create a new project/application with Fantasy Sports API access
3. Make note of your Client ID and Client Secret
4. Add these values to your .env file:

   YAHOO_CLIENT_ID=your_client_id
   YAHOO_CLIENT_SECRET=your_client_secret
   

5. To get an access token, you may need to:
   • Use the Yahoo Developer Console to generate a token
   • Use a tool like Postman with OAuth 1.0a support
   • Follow Yahoo's official documentation for the latest OAuth workflow
6. Once obtained, add the access token to your .env file:

   YAHOO_ACCESS_TOKEN=your_access_token
   

Building and Running the Server

Build the TypeScript files:

npm run build

Start the server:

npm start

MCP Configuration

To add this server to your Claude configuration, add the following to your MCP settings file:

"yahoo-fantasy-baseball": {
  "autoApprove": [],
  "disabled": false,
  "timeout": 60,
  "command": "node",
  "args": ["path/to/yahoo-fantasy-baseball-MCP/build/index.js"],
  "env": {
    "YAHOO_CLIENT_ID": "your_yahoo_client_id",
    "YAHOO_CLIENT_SECRET": "your_yahoo_client_secret",
    "YAHOO_ACCESS_TOKEN": "your_access_token"
  },
  "transportType": "stdio"
}

Available Tools

get_team_roster

Retrieves the current roster for a team.

Parameters:

• team_key (optional): Yahoo team key. Defaults to your primary team.

Example usage:

Use the get_team_roster tool to see my current lineup.

get_waiver_players (Coming Soon)

Lists available players on the waiver wire with relevant stats.

get_matchup (Coming Soon)

Provides details about your current matchup.

License

MIT