> ## Documentation Index
> Fetch the complete documentation index at: https://padelapi.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# About the Padel Analyst

> Connect AI assistants like Claude, ChatGPT, and VS Code to professional padel data through the Padel API MCP Server

> <Icon icon="language" /> ¿Prefieres leerlo en español? Esta página también está disponible en [español](/docs/padel-analyst/acerca-de).

## Your AI doesn't know padel yet

Ask ChatGPT for a result or a head-to-head and it often improvises: it confuses players, mixes up tournaments, or makes up scores. **Padel Analyst fixes that:** it connects your AI assistant to the database behind [Padel API](https://padelapi.org), so its answers come from a reliable, up-to-date source instead of the model's memory.

<iframe width="100%" height="400" src="https://www.youtube.com/embed/Aj1-tTvVLv8" title="Padel Analyst Presentation" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

Here's what you'll be able to ask your AI assistant once you connect it:

<AccordionGroup>
  <Accordion title="Player information">
    * "Who is Arturo Coello? Give me his profile and recent results"
    * "List the top 10 ranked women players"
    * "Find all Spanish players who play on the backhand side"
  </Accordion>

  <Accordion title="Match analysis">
    * "What were the results of the last Premier Padel Major?"
    * "Show me the head-to-head record between Lebron/Galan and Coello/Tapia"
    * "Get the point-by-point statistics from yesterday's final"
  </Accordion>

  <Accordion title="Tournament data">
    * "List all P1 tournaments this season"
    * "Who won the Qatar Major 2024?"
    * "Show me the draw and results from the Paris Premier Padel"
  </Accordion>

  <Accordion title="Predictions">
    * "Simulate a match between Coello/Tapia vs Lebron/Galan"
    * "Based on recent form, who would win: Sanchez/Josemaria or Triay/Fernandez?"
  </Accordion>
</AccordionGroup>

## Who it's for

Padel Analyst turns your AI assistant into a padel analyst for anyone who lives the sport but doesn't want to dig through spreadsheets:

<CardGroup cols={2}>
  <Card title="Fans" icon="users">
    Settle debates and get the head-to-head for any matchup instantly.
  </Card>

  <Card title="Creators" icon="video">
    Prep previews, threads, and videos with solid data in minutes.
  </Card>

  <Card title="Journalists & media" icon="newspaper">
    Pull accurate stats and context in seconds, straight from your chat.
  </Card>

  <Card title="Sponsors" icon="handshake">
    Evaluate players and pairs with real data before investing in a sponsorship.
  </Card>
</CardGroup>

## Get started in 3 steps

Padel Analyst is an **MCP (Model Context Protocol)** server that connects your AI assistant to professional padel data, so you can ask in natural language without writing any code. Connect it in three steps:

<Steps>
  <Step title="Subscribe to the Plus Plan">
    Sign up for the [Plus Plan](https://padelapi.org/billing) (19€/month) which includes:

    * Up to 50K requests/month
    * MCP Server Access
    * Works with ChatGPT
    * Natural language queries
    * Basic support
  </Step>

  <Step title="Create an API Token">
    Generate your personal API token from the [API Tokens](https://padelapi.org/user/api-tokens) page. You'll need this to authenticate MCP requests.
  </Step>

  <Step title="Connect your AI assistant">
    Choose your assistant and follow the installation guide to start asking:

    <CardGroup cols={2}>
      <Card title="Connect to ChatGPT" icon="comments" href="/docs/padel-analyst/chatgpt">
        Add Padel Analyst in ChatGPT's Developer mode.
      </Card>

      <Card title="Connect to Claude" icon="robot" href="/docs/padel-analyst/claude">
        The easiest way — add it as a connector, no config files.
      </Card>
    </CardGroup>
  </Step>
</Steps>

### Connect other clients

<AccordionGroup>
  <Accordion title="Cursor">
    Click the button below to install the Padel API MCP server in Cursor:

    [![Install in Cursor](https://img.shields.io/badge/Cursor-Install_Server-000000?style=flat-square\&logo=cursor\&logoColor=white)](cursor://anysphere.cursor-deeplink/mcp/install?name=Padel%20API\&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vcGFkZWxhcGkub3JnL21jcCJ9)

    Or manually add the following to your Cursor MCP settings (`~/.cursor/mcp.json`):

    ```json theme={null}
    {
      "mcpServers": {
        "padel-api": {
          "type": "http",
          "url": "https://padelapi.org/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_TOKEN"
          }
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="VS Code / GitHub Copilot">
    Click the button below to install the Padel API MCP server in VS Code:

    [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square\&logo=visualstudiocode\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=padel-api\&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fpadelapi.org%2Fmcp%22%7D)

    Or manually add the following to your VS Code `settings.json`:

    ```json theme={null}
    {
      "mcp": {
        "servers": {
          "padel-api": {
            "type": "http",
            "url": "https://padelapi.org/mcp",
            "headers": {
              "Authorization": "Bearer YOUR_API_TOKEN"
            }
          }
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Windsurf">
    Add the following to your Windsurf MCP configuration file (`~/.codeium/windsurf/mcp_config.json`):

    ```json theme={null}
    {
      "mcpServers": {
        "padel-api": {
          "type": "http",
          "url": "https://padelapi.org/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_TOKEN"
          }
        }
      }
    }
    ```

    You can also install via the MCP Marketplace: open Windsurf Settings → Cascade → MCP Servers, and search for "Padel API".
  </Accordion>

  <Accordion title="Claude Desktop">
    Add the following to your Claude Desktop configuration file:

    <Tabs>
      <Tab title="macOS">
        Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:

        ```json theme={null}
        {
          "mcpServers": {
            "padel-api": {
              "type": "http",
              "url": "https://padelapi.org/mcp",
              "headers": {
                "Authorization": "Bearer YOUR_API_TOKEN"
              }
            }
          }
        }
        ```
      </Tab>

      <Tab title="Windows">
        Edit `%APPDATA%\Claude\claude_desktop_config.json`:

        ```json theme={null}
        {
          "mcpServers": {
            "padel-api": {
              "type": "http",
              "url": "https://padelapi.org/mcp",
              "headers": {
                "Authorization": "Bearer YOUR_API_TOKEN"
              }
            }
          }
        }
        ```
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Other MCP clients">
    For any MCP-compatible client, use these connection details:

    | Setting        | Value                                  |
    | -------------- | -------------------------------------- |
    | Server URL     | `https://padelapi.org/mcp`             |
    | Transport      | HTTP (Streamable)                      |
    | Authentication | Bearer token in `Authorization` header |
  </Accordion>
</AccordionGroup>

## Available Tools

The Padel Analyst MCP server provides 16 tools for querying padel data:

| Tool                      | Description                                                              |
| ------------------------- | ------------------------------------------------------------------------ |
| `list-pair-matches`       | Get all matches for a specific pair of players                           |
| `list-player-matches`     | Get all matches for a specific player                                    |
| `list-player-rankings`    | Get ranking snapshots and weekly history for a player                    |
| `list-rankings`           | Get the FIP ranking list for a given week, including biggest movers      |
| `list-tournament-matches` | Get all matches from a tournament                                        |
| `search-headtohead`       | Find head-to-head matches between specific players                       |
| `search-matches`          | Search for matches with various filters                                  |
| `search-pairs`            | List player pairs that have played together, with status and match dates |
| `search-players`          | Search players by name, nationality, category, or side                   |
| `search-seasons`          | Browse available seasons and competitions                                |
| `search-tournaments`      | Find tournaments by name, level, or date range                           |
| `show-match-live`         | Get point-by-point play-by-play data for a match                         |
| `show-match-stats`        | Get detailed match statistics including point-by-point data              |
| `show-pair-stats`         | Display statistics for a pair of players                                 |
| `show-player-stats`       | Display detailed statistics for a player                                 |
| `simulate-match`          | Simulate a match outcome based on player statistics                      |

## Available Prompts

Pre-configured prompts help structure common analysis tasks:

| Prompt               | Description                                          |
| -------------------- | ---------------------------------------------------- |
| `head-to-head`       | Compare historical results between two players/pairs |
| `match-preview`      | Generate a preview for an upcoming match             |
| `pair-analysis`      | Analyze a pair's performance and playing style       |
| `player-comparison`  | Side-by-side comparison of two players               |
| `player-profile`     | Comprehensive profile of a player                    |
| `recent-results`     | Summary of recent match results                      |
| `season-overview`    | Overview of a complete season                        |
| `tournament-summary` | Summary of a tournament with results                 |

## Beyond Match Data

Padel Analyst gives you access to performance data: rankings, results, and statistics. If you also need **fan engagement analytics**, check out [Padel Fan Index](/docs/guides/padel-fan-index), which combines this data with real fan decisions from Fantasy Padel Tour.

## Support

Need help? Contact us at [ferran@padelapi.org](mailto:ferran@padelapi.org) or check the [API documentation](/docs/index) for more details on available data.