# YorkerAPI MCP Server

18 cricket data tools for AI assistants. Cricket ball by ball in every format, men's and women's, joined to sportsbook match-winner prices. All tools return structured output schemas for reliable parsing.

## Server URL

```
https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY
```

Transport: Streamable HTTP

## Get an API Key

1. Sign up at https://yorkerapi.com/signup (free, 500 credits every month)
2. Go to https://yorkerapi.com/dashboard/keys
3. Create a key (starts with `sk_live_`)

## Setup

### Claude Code

```bash
claude mcp add --transport http --scope user yorkerapi "https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY"
```

### Claude Desktop

Add to config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows):

```json
{
  "mcpServers": {
    "yorkerapi": {
      "url": "https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "yorkerapi": {
      "url": "https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

### VS Code (GitHub Copilot)

Add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "yorkerapi": {
      "type": "streamable-http",
      "url": "https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

### Cline

Settings > MCP Servers > Add Remote Server:
- Name: `yorkerapi`
- URL: `https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY`

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "yorkerapi": {
      "serverUrl": "https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

## Available Tools

| Category | Tools | Credits |
|----------|-------|---------|
| Static reference | list_competitions, list_teams, search_players | 1 |
| Basic lookup | get_schedule, get_matches, get_ratings | 2 |
| Multi-table | get_match, get_odds | 5 |
| Stats + aggregation | get_player, get_player_stats, get_player_matches, get_matchup, get_leaders, get_venue | 5 |
| Time-series | get_deliveries, get_win_probability, get_market_vs_model, get_line_movement | 10 |

## Pricing

500 free credits every month. Plans from $19/mo at https://yorkerapi.com/dashboard/billing

## Documentation

Full API docs: https://yorkerapi.com/docs
MCP setup guide: https://yorkerapi.com/docs#claude-desktop