# BirdieAPI MCP Server

13 golf data tools for AI assistants. PGA Tour data since 2001: leaderboards, hole-by-hole scores, courses and ratings. REST and MCP. All tools return structured output schemas for reliable parsing.

## Server URL

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

Transport: Streamable HTTP

## Get an API Key

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

## Setup

### Claude Code

```bash
claude mcp add --transport http --scope user birdieapi "https://mcp.birdieapi.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": {
    "birdieapi": {
      "url": "https://mcp.birdieapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

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

### VS Code (GitHub Copilot)

Add to `.vscode/mcp.json`:

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

### Cline

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

### Windsurf

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

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

## Available Tools

| Category | Tools | Credits |
|----------|-------|---------|
| Static reference | list_tournaments, search_players, get_schedule | 1 |
| Basic lookup | get_leaderboard, get_scorecard, get_course, get_ratings | 2 |
| Stats + aggregation | get_player, get_player_results, get_player_stats, get_course_history, get_head_to_head, get_leaders | 5 |

## Pricing

500 free credits on signup. Plans from $19/mo at https://birdieapi.com/dashboard/billing.

## Documentation

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