open-index/open-npm huggingface dataset:
npm package: @sportsstack/mcp-server
Description: MCP server for SportsStack API — AI agent access to live sports data, scores, odds, stats, and more
Latest version: 0.1.0

# @sportsstack/mcp-server

MCP server for the [SportsStack API](https://sportsstack.readme.io) — gives AI agents access to live sports data, scores, odds, stats, standings, injuries, and more.

## Quick Start

```bash
npx -y @sportsstack/mcp-server
```

## Setup

### Claude Desktop / Claude Code

Add to your MCP config (`~/.claude/settings/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "sportsstack": {
      "command": "npx",
      "args": ["-y", "@sportsstack/mcp-server"],
      "env": {
        "SPORTSSTACK_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "sportsstack": {
      "command": "npx",
      "args": ["-y", "@sportsstack/mcp-server"],
      "env": {
        "SPORTSSTACK_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

### Gemini CLI

```bash
SPORTSSTACK_API_KEY=your-key npx -y @sportsstack/mcp-server
```

## Authentication

Set the `SPORTSSTACK_API_KEY` environment variable. Without a key, the server runs in **free trial mode** (100 requests/hour).

Get an API key at [sportsstack.readme.io](https://sportsstack.readme.io/docs/getting-started).

## Tools

| Tool | Description |
|------|-------------|
| `get_sports_list` | List all supported sports and leagues |
| `get_schedule` | Upcoming/past games by league, team, date |
| `get_live_scores` | Real-time scores for in-progress games |
| `get_standings` | League standings with W/L/PCT |
| `search_teams` | Fuzzy team search by name/city/abbreviation |
| `search_players` | Fuzzy player search with nickname support |
| `get_team_roster` | Current roster for a team |
| `get_player_stats` | Season averages, totals, or game log |
| `get_event_details` | Comprehensive event details with optional stats/odds |
| `get_betting_odds` | Multi-sportsbook odds for an event |
| `get_injuries` | Injury reports with cross-provider validation |

## Supported Leagues

NFL, NBA, MLB, NHL, NCAAF, NCAAB, WNBA, EPL, MLS, PGA, Champions League, and more. Use `get_sports_list` to see the full list.

## Example Queries

Once connected, ask your AI agent:

- "What NFL games are on this week?"
- "Show me the NBA standings"
- "What are the odds for the Chiefs game?"
- "Look up Patrick Mahomes' stats this season"
- "Who's injured on the Lakers?"
- "Search for teams named 'Giants'"

## Development

```bash
cd packages/mcp-server
npm install
npm run build      # Build with tsup
npm run lint       # TypeScript type check
npm run test:unit  # Unit tests
npm run test       # All tests
```

## Requirements

- Node.js >= 18.0.0
npm package: @sportswik/icons-react
Description: Sportswik icon components for React
Latest version: 0.2.7

# @sportswik/icons-react

Tree-shakable React icon components generated from the canonical SVGs in this repo.

## Install

```bash
npm i @sportswik/icons-react
```

## Usage

```tsx
import PlayCircle from "@sportswik/icons-react/PlayCircle";

export function Button() {
  return <PlayCircle width={24} height={24} />;
}
```

All icons inherit color via `currentColor`. Use CSS or inline styles to tint:

```tsx
<PlayCircle style={{ color: "#0EA5E9" }} />
```

## Storybook & Chromatic

View all icons in Storybook:

```bash
npm run storybook
```

Build Storybook static site:

```bash
npm run build-storybook
```

Run Chromatic for visual regression testing:

```bash
npm run chromatic
```

The Chromatic workflow runs automatically on pushes and pull requests via GitHub Actions.