SPORTS_ENDPOINTS.md•2.13 kB
# ESPN API Sports Endpoints Testing Results
## Working Sports Endpoints
Based on systematic testing of ESPN API endpoints, here are the confirmed working patterns:
### Standard Sports (Using Standard Pattern)
- **NFL**: `football/nfl/news` ✅
- **NBA**: `basketball/nba/news` ✅
- **MLB**: `baseball/mlb/news` ✅
- **NHL**: `hockey/nhl/news` ✅
### Sports Requiring League-Specific Endpoints
#### Soccer
- **Generic soccer endpoint**: `soccer/news` ❌ (404 error)
- **Premier League**: `soccer/eng.1/news` ✅
- **MLS**: `soccer/usa.1/news` ✅
- **Champions League**: `soccer/uefa.champions/news` ✅
- **La Liga**: `soccer/esp.1/news` ✅
#### Golf
- **Generic golf endpoint**: `golf/news` ❌ (404 error)
- **PGA Tour**: `golf/pga/news` ✅
#### Tennis
- **Generic tennis endpoint**: `tennis/news` ❌ (404 error)
- **ATP Tour**: `tennis/atp/news` ✅
- **WTA Tour**: `tennis/wta/news` ✅
#### Motor Sports
- **F1 Racing**: `racing/f1/news` ✅
- **NASCAR**: Various paths tested, none successful ❌
- `racing/nascar/news` ❌
- `racing/nascar/cup/news` ❌
- `racing/nascar/monster-energy/news` ❌
- `motor/nascar/news` ❌
#### NCAA Sports
- **Men's College Basketball**: `basketball/mens-college-basketball/news` ✅
- **Women's College Basketball**: `basketball/womens-college-basketball/news` ✅
- **College Football**: `football/college-football/news` ✅
## Implementation in MCP Server
The `get_sports_news` tool in `modern-server.ts` has been updated to handle these endpoint patterns:
1. **Standard sports** use the normal pattern
2. **Soccer** aggregates news from multiple major leagues
3. **Golf** uses PGA tour endpoint
4. **Tennis** aggregates ATP and WTA news
5. **F1** uses racing/f1 endpoint
6. **NCAA sports** use college-specific endpoints
## Notes
- Some sports require league-specific endpoints rather than generic sport endpoints
- ESPN API structure is inconsistent across different sports
- NASCAR endpoints could not be found - may require different API base or structure
- All tested endpoints return proper JSON responses with news articles, teams, and player information