Skip to main content

​
What is Padel Analyst?

Padel Analyst is an MCP (Model Context Protocol) server that connects AI assistants to professional padel data. It allows you to ask natural language questions about players, tournaments, matches, and statistics without writing any code.

Natural Language

Ask questions like “Who won the last Major?” or “Compare Lebron vs Galan”

Real-time Data

Access live scores, recent results, and up-to-date statistics

Multiple AI Hosts

Works with Claude, ChatGPT, VS Code, and any MCP-compatible client

​
Prerequisites

1

Subscribe to the Analyst Plan

Sign up for the Analyst Plan (19€/month) which includes:
  • Up to 50K requests/month
  • MCP Server Access
  • Works with ChatGPT
  • Natural language queries
  • Basic support
2

Create an API Token

Generate your personal API token from the API Tokens page. You’ll need this to authenticate MCP requests.

​
Available Tools

The Padel Analyst MCP server provides 12 tools for querying padel data:
ToolDescription
list-pair-matchesGet all matches for a specific pair of players
list-player-matchesGet all matches for a specific player
list-tournament-matchesGet all matches from a tournament
search-headtoheadFind head-to-head matches between specific players
search-matchesSearch for matches with various filters
search-playersSearch players by name, nationality, category, or side
search-seasonsBrowse available seasons and competitions
search-tournamentsFind tournaments by name, level, or date range
show-match-statsGet detailed match statistics including point-by-point data
show-pair-statsDisplay statistics for a pair of players
show-player-statsDisplay detailed statistics for a player
simulate-matchSimulate a match outcome based on player statistics

​
Available Prompts

Pre-configured prompts help structure common analysis tasks:
PromptDescription
head-to-headCompare historical results between two players/pairs
match-previewGenerate a preview for an upcoming match
pair-analysisAnalyze a pair’s performance and playing style
player-comparisonSide-by-side comparison of two players
player-profileComprehensive profile of a player
recent-resultsSummary of recent match results
season-overviewOverview of a complete season
tournament-summarySummary of a tournament with results

​
Installation

​
ChatGPT

Follow our step-by-step installation guide to add Padel Analyst to ChatGPT using Developer mode.

​
Claude.ai

Follow our step-by-step installation guide to add Padel Analyst as a connector in Claude.ai. This is the easiest way to get started - no configuration files needed.

​
VS Code / GitHub Copilot

Click the button below to install the Padel API MCP server in VS Code: Install in VS Code Or manually add the following to your VS Code settings.json: 
{
  "mcp": {
    "servers": {
      "padel-api": {
        "type": "http",
        "url": "https://padelapi.org/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_TOKEN"
        }
      }
    }
  }
}

​
Claude Desktop

Add the following to your Claude Desktop configuration file:
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "padel-api": {
      "type": "http",
      "url": "https://padelapi.org/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

​
Other MCP Clients

For any MCP-compatible client, use these connection details:
SettingValue
Server URLhttps://padelapi.org/mcp
TransportHTTP (Streamable)
AuthenticationBearer token in Authorization header

​
Example Queries

Once connected, you can ask your AI assistant questions like:
  • “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”
  • “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”
  • “List all P1 tournaments this season”
  • “Who won the Qatar Major 2024?”
  • “Show me the draw and results from the Paris Premier Padel”
  • “Simulate a match between Coello/Tapia vs Lebron/Galan”
  • “Based on recent form, who would win: Sanchez/Josemaria or Triay/Fernandez?”

​
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, which combines this data with real fan decisions from Fantasy Padel Tour.

​
Support

Need help? Contact us at [email protected] or check the API documentation for more details on available data.