> ## 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.
# Acerca de Padel Analyst
> Conecta asistentes de IA como Claude, ChatGPT y VS Code a datos profesionales de pádel a través del servidor MCP de Padel API
> Prefer to read it in English? This page is also available in [English](/docs/padel-analyst).
## Tu IA aún no sabe de pádel
Pregúntale a ChatGPT por un resultado o un cara a cara y a menudo improvisa: confunde jugadores, mezcla torneos o se inventa marcadores. **Padel Analyst lo soluciona:** conecta tu asistente de IA con la base de datos que hay detrás de [Padel API](https://padelapi.org), para que sus respuestas vengan de una fuente fiable y actualizada en lugar de la memoria del modelo.
Esto es lo que podrás pedirle a tu asistente de IA en cuanto lo conectes:
* "¿Quién es Arturo Coello? Dame su perfil y resultados recientes"
* "Lista los 10 mejores jugadores del ranking femenino"
* "Encuentra todos los jugadores españoles que juegan en el lado del revés"
* "¿Cuáles fueron los resultados del último Major de Premier Padel?"
* "Muéstrame el historial de enfrentamientos entre Lebrón/Galán y Coello/Tapia"
* "Dame las estadísticas punto a punto de la final de ayer"
* "Lista todos los torneos P1 de esta temporada"
* "¿Quién ganó el Qatar Major 2024?"
* "Muéstrame el cuadro y resultados del Paris Premier Padel"
* "Simula un partido entre Coello/Tapia vs Lebrón/Galán"
* "Basándote en la forma reciente, ¿quién ganaría: Sánchez/Josemaría o Triay/Fernández?"
## Para quién es
Padel Analyst convierte tu asistente de IA en un analista de pádel para cualquiera que viva el deporte pero no quiera bucear entre hojas de cálculo:
Zanja debates y consigue al instante el cara a cara de cualquier cruce.
Prepara previas, hilos y vídeos con datos sólidos en minutos.
Saca estadísticas y contexto precisos en segundos, directamente desde tu chat.
Valora jugadores y parejas con datos reales antes de invertir en un patrocinio.
## Empieza en 3 pasos
Padel Analyst es un servidor **MCP (Model Context Protocol)** que conecta tu asistente de IA con datos profesionales de pádel, para que le preguntes en lenguaje natural sin escribir código. Conéctalo en tres pasos:
Regístrate en el [Plan Plus](https://padelapi.org/billing) (19€/mes) que incluye:
* Hasta 50K peticiones/mes
* Acceso al servidor MCP
* Funciona con ChatGPT
* Consultas en lenguaje natural
* Soporte básico
Genera tu token personal de API desde la página de [Tokens de API](https://padelapi.org/user/api-tokens). Lo necesitarás para autenticar las peticiones MCP.
Elige tu asistente y sigue la guía de instalación para empezar a preguntar:
Añade Padel Analyst en el modo Desarrollador de ChatGPT.
La forma más fácil — añádelo como conector, sin archivos de configuración.
### Conectar otros clientes
Haz clic en el botón de abajo para instalar el servidor MCP de Padel API en Cursor:
[](cursor://anysphere.cursor-deeplink/mcp/install?name=Padel%20API\&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vcGFkZWxhcGkub3JnL21jcCJ9)
O añade manualmente lo siguiente a la configuración MCP de Cursor (`~/.cursor/mcp.json`):
```json theme={null}
{
"mcpServers": {
"padel-api": {
"type": "http",
"url": "https://padelapi.org/mcp",
"headers": {
"Authorization": "Bearer TU_TOKEN_DE_API"
}
}
}
}
```
Haz clic en el botón de abajo para instalar el servidor MCP de Padel API en VS Code:
[](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)
O añade manualmente lo siguiente a tu `settings.json` de VS Code:
```json theme={null}
{
"mcp": {
"servers": {
"padel-api": {
"type": "http",
"url": "https://padelapi.org/mcp",
"headers": {
"Authorization": "Bearer TU_TOKEN_DE_API"
}
}
}
}
}
```
Añade lo siguiente a tu archivo de configuración MCP de Windsurf (`~/.codeium/windsurf/mcp_config.json`):
```json theme={null}
{
"mcpServers": {
"padel-api": {
"type": "http",
"url": "https://padelapi.org/mcp",
"headers": {
"Authorization": "Bearer TU_TOKEN_DE_API"
}
}
}
}
```
También puedes instalarlo desde el MCP Marketplace: abre Windsurf Settings → Cascade → MCP Servers, y busca "Padel API".
Añade lo siguiente a tu archivo de configuración de Claude Desktop:
Edita `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json theme={null}
{
"mcpServers": {
"padel-api": {
"type": "http",
"url": "https://padelapi.org/mcp",
"headers": {
"Authorization": "Bearer TU_TOKEN_DE_API"
}
}
}
}
```
Edita `%APPDATA%\Claude\claude_desktop_config.json`:
```json theme={null}
{
"mcpServers": {
"padel-api": {
"type": "http",
"url": "https://padelapi.org/mcp",
"headers": {
"Authorization": "Bearer TU_TOKEN_DE_API"
}
}
}
}
```
Para cualquier cliente compatible con MCP, usa estos datos de conexión:
| Configuración | Valor |
| ---------------- | ------------------------------------------- |
| URL del servidor | `https://padelapi.org/mcp` |
| Transporte | HTTP (Streamable) |
| Autenticación | Bearer token en la cabecera `Authorization` |
## Herramientas Disponibles
El servidor MCP de Padel Analyst proporciona 16 herramientas para consultar datos de pádel:
| Herramienta | Descripción |
| ------------------------- | ------------------------------------------------------------------------------------- |
| `list-pair-matches` | Obtener todos los partidos de una pareja de jugadores |
| `list-player-matches` | Obtener todos los partidos de un jugador |
| `list-player-rankings` | Obtener las posiciones del ranking y el histórico semanal de un jugador |
| `list-rankings` | Obtener el ranking FIP de una semana, incluyendo los que más suben y bajan |
| `list-tournament-matches` | Obtener todos los partidos de un torneo |
| `search-headtohead` | Buscar enfrentamientos directos entre jugadores |
| `search-matches` | Buscar partidos con varios filtros |
| `search-pairs` | Listar parejas de jugadores que han jugado juntas, con su estado y fechas de partidos |
| `search-players` | Buscar jugadores por nombre, nacionalidad, categoría o lado |
| `search-seasons` | Explorar temporadas y competiciones disponibles |
| `search-tournaments` | Buscar torneos por nombre, nivel o rango de fechas |
| `show-match-live` | Obtener los datos punto a punto de un partido |
| `show-match-stats` | Obtener estadísticas detalladas de un partido, incluyendo datos punto a punto |
| `show-pair-stats` | Mostrar estadísticas de una pareja de jugadores |
| `show-player-stats` | Mostrar estadísticas detalladas de un jugador |
| `simulate-match` | Simular el resultado de un partido basándose en estadísticas |
## Prompts Disponibles
Los prompts preconfigurados ayudan a estructurar tareas de análisis comunes:
| Prompt | Descripción |
| -------------------- | ---------------------------------------------------------- |
| `head-to-head` | Comparar resultados históricos entre dos jugadores/parejas |
| `match-preview` | Generar una previa de un próximo partido |
| `pair-analysis` | Analizar el rendimiento y estilo de juego de una pareja |
| `player-comparison` | Comparación lado a lado de dos jugadores |
| `player-profile` | Perfil completo de un jugador |
| `recent-results` | Resumen de resultados recientes |
| `season-overview` | Resumen de una temporada completa |
| `tournament-summary` | Resumen de un torneo con resultados |
## Más Allá de los Datos de Partidos
Padel Analyst te da acceso a datos de rendimiento: rankings, resultados y estadísticas. Si también necesitas **análisis de engagement de fans**, consulta [Padel Fan Index](/docs/guides/padel-fan-index), que combina estos datos con decisiones reales de fans de Fantasy Padel Tour.
## Soporte
¿Necesitas ayuda? Contáctanos en [ferran@padelapi.org](mailto:ferran@padelapi.org) o consulta la [documentación de la API](/docs/index) para más detalles sobre los datos disponibles.