# Padel Analyst

**Padel Analyst** by [Padel API](https://padelapi.org) is an MCP server that connects AI assistants to professional padel data. It allows you to ask natural language questions about players, tourname…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add ferranfg/padelapi

# Browse available tools
npx -y @smithery/cli@latest tool list ferranfg/padelapi

# Get full schema for a tool
npx -y @smithery/cli@latest tool get ferranfg/padelapi list-pair-matches

# Call a tool
npx -y @smithery/cli@latest tool call ferranfg/padelapi list-pair-matches '{}'
```

## Direct MCP Connection

Endpoint: `https://padelapi--ferranfg.run.tools`

**Required config:**
- `token` (query)

## Tools (12)

- `list-pair-matches` — List matches played by a pair of players. To get the player IDs, use the "search-players" tool.
- `search-player-matches` — List the matches of a player by providing their player ID. Use only parameter values that you are certain about. To get…
- `list-tournament-matches` — List all matches of a tournament by providing the tournament ID. To get the tournament ID, use the "search-tournaments"…
- `search-matches-related` — Endpoint to retrieve head-to-head or related list of matches between players. This endpoint can be used to find matches…
- `search-matches` — Search matches by date, and round to get match details. To list all matches of a tournament, use the "list-tournament-m…
- `search-players` — Search players by name or surname to get player information and details (player ID, name, age, etc.).
- `search-seasons` — Search seasons by year to get season details. Seasons from 2023 onwards are available.
- `search-tournaments` — Search tournaments by name and other filters to get tournament details. Use only parameter values that you are certain …
- `show-match-stats` — Get detailed match statistics for a specific match ID
- `show-pair-stats` — Get statistics for a pair of players by providing their player IDs. To get the player IDs, use the "search-players" too…
- `show-player-stats` — Get statistics for a player by providing their player ID. To get the player ID, use the "search-players" tool.
- `simulate-match` — Simulate a match between players from two teams. Provide player IDs for both teams to simulate the match outcome. To ge…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get ferranfg/padelapi <tool-name>
```

## Prompts (8)

- `head-to-head` (player_1_name, player_2_name) — Compare two players or pairs with historical matchups and stats
- `match-preview` (team_1_player_1, team_1_player_2, team_2_player_1, team_2_player_2) — Preview an upcoming match: player/pair stats, head-to-head history, simulation
- `pair-analysis` (player_1_name, player_2_name) — Analyze a pair's performance: matches played together, win rate, stats
- `player-comparison` (player_1_name, player_2_name) — Compare two players: rankings, stats, recent form
- `player-profile` (player_name) — Get comprehensive player info: bio, ranking, recent matches, and stats
- `recent-results` (category, days) — Get recent match results with optional category filter
- `season-overview` (year) — Summarize a season: all tournaments, winners, key stats
- `tournament-summary` (tournament_name) — Get tournament info: schedule, matches, results by round