# Sleeper MCP Server

A Machine Context Protocol (MCP) server for integrating Sleeper fantasy sports data with Goose AI. This server implements the MCP specification to provide structured access to Sleeper's API data.

## Overview

The Sleeper MCP Server acts as a bridge between Goose AI and the Sleeper Fantasy Sports platform, implementing the Model Context Protocol (MCP) for seamless integration.

Features:
- Structured access to fantasy sports data via MCP
- Rate-limited API access
- Data caching and optimization
- OpenAPI documentation
- MCP-compliant function specifications

## Installation

```bash
# Clone the repository
git clone https://github.com/yourusername/sleeper-mcp.git
cd sleeper-mcp

# Install dependencies using Poetry
poetry install

# Start the server
poetry run uvicorn src.main:app
```

## Integration with Goose

The Sleeper MCP server integrates with Goose in two ways:

1. Start the server:
```bash
poetry run uvicorn src.main:app
```

2. Use with Goose:

a. Via session:
```bash
goose session --with-extension "uvicorn src.main:app"
```

b. Via single command:
```bash
goose run --with-extension "uvicorn src.main:app" -t "your instructions"
```

Available functions:
- `get_user(identifier: str)` - Get user information
- `get_user_leagues(user_id: str, season: str)` - Get leagues for a user
- `get_league(league_id: str)` - Get league details
- `get_league_rosters(league_id: str)` - Get league rosters
- `get_league_users(league_id: str)` - Get league users
- `get_nfl_state()` - Get NFL season state

## MCP Protocol Implementation

This server implements the Model Context Protocol (v2024-11-05) which includes:

1. Initialization Phase:
   - Server capability discovery
   - Protocol version negotiation
   - Feature negotiation

2. Operation Phase:
   - Function discovery and invocation
   - Resource access
   - Error handling

3. Security:
   - Rate limiting
   - Error reporting
   - Access controls

## Development

### Project Structure

```
sleeper-mcp/
├── docs/
│   ├── openapi.yaml        # API specification
│   └── sleeper_api_raw.html # Raw API documentation
├── src/
│   ├── api/               # API endpoints
│   ├── models/            # Data models
│   ├── mcp/              # MCP protocol implementation
│   ├── services/         # Business logic
│   └── config/           # Configuration
├── tests/                # Test suites
├── pyproject.toml        # Project dependencies
├── README.md            # This file
└── TODO.md             # Development tasks
```

### Running Tests

```bash
poetry run pytest
```

### Development Server

```bash
poetry run uvicorn src.main:app --reload
```

## Security Considerations

As per MCP specification:
- No authentication required (read-only API)
- Rate limiting enforced (1000 requests/minute)
- No sensitive data exposure
- Clear error reporting

## API Documentation

- OpenAPI documentation: `/docs`
- Raw API documentation: `/docs/sleeper_api_raw.html`
- MCP capabilities: `/capabilities`

## License

[Add your chosen license]

## Acknowledgments

- Sleeper API Team
- Model Context Protocol Specification
- Goose AI Team