Skip to main content
This guide shows you how to add Padel Analyst to Claude Code, Anthropic’s CLI, so you can query professional padel data directly from your terminal or IDE.

​
Prerequisites

Before you begin, make sure you have:

Claude Code Installed

Install with npm install -g @anthropic-ai/claude-code

Padel API Token

Get your token from the API Tokens page

​
Installation Steps

1

Add the MCP server

Run the following command, replacing YOUR_API_TOKEN with your token from the API Tokens page:
claude mcp add --transport http padel-api https://padelapi.org/mcp \
  --header "Authorization: Bearer YOUR_API_TOKEN"
By default the server is added at the local scope (available only to you in the current project). Use --scope user to make it available across all your projects, or --scope project to share it with your team via a checked-in .mcp.json.
2

Verify the connection

List your configured MCP servers to confirm it was added and is reachable:
claude mcp list
You can also run /mcp inside a Claude Code session to see the server status and its available tools.
3

Start querying

Open a Claude Code session and ask a question about professional padel. Claude Code will call the Padel Analyst tools automatically when it needs data.

​
Configuration File

If you prefer to edit configuration directly, add Padel Analyst to your .mcp.json (project scope) or ~/.claude.json (user scope): 
{
  "mcpServers": {
    "padel-api": {
      "type": "http",
      "url": "https://padelapi.org/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

​
Example Questions

Try asking Claude Code questions like:
  • “Who won the last Premier Padel Major?”
  • “Show me the head-to-head between Lebron/Galan and Coello/Tapia”
  • “What are Arturo Coello’s statistics this season?”
  • “List all P1 tournaments in 2025”
  • “Simulate a match between the top two ranked pairs”

​
Troubleshooting

Verify your API token is correct and that you have an active Plus plan subscription. Re-run the claude mcp add command with the corrected header.
Local-scope servers are project-specific. Re-add with --scope user to make Padel Analyst available everywhere.
Make sure the header is passed exactly as Authorization: Bearer YOUR_API_TOKEN and that your token hasn’t expired.

​
Next Steps

Available Tools

See all 12 tools available for querying padel data

Access Padel API

Explore the full REST API behind Padel Analyst