MCP Setup

MCP endpoint

• Hosted MCP URL: https://www.padelful.com/api/mcp

Option 1: Hosted MCP (recommended)

Use the hosted URL if you want the fastest setup and no local process.

Claude Desktop

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "padelful": {
      "url": "https://www.padelful.com/api/mcp"
    }
  }
}

Cursor / Windsurf

Add this to your MCP config:

{
  "padelful": {
    "url": "https://www.padelful.com/api/mcp"
  }
}

ChatGPT

1. Open ChatGPT -> Settings -> Connectors.
2. Add a new MCP connector.
3. Use https://www.padelful.com/api/mcp as the connector URL.

Option 2: Run locally via npm

Use local mode when you want to test package changes before publish.

{
  "mcpServers": {
    "padelful": {
      "command": "npx",
      "args": ["@padelful/mcp-server"]
    }
  }
}

Available tools

• search_rackets: search by brand, shape, rating, query
• get_racket: get full specs for one racket
• compare_rackets: compare 2 to 4 rackets
• get_recommendations: get profile-based recommendations
• get_prices: fetch current prices from stores

Quick prompts

• "Best control racket for an intermediate player under 200 EUR"
• "Compare babolat-technical-viper-2025 vs bullpadel-hack-03-2025"
• "Find round rackets with rating above 8.0"
• "Recommend rackets for advanced power players"

Troubleshooting

• Connection failed: verify the MCP URL and restart your client.
• No tools available: confirm your config path and JSON validity.
• Rate limited: retry after a short delay.
• No prices returned: get_prices may need Supabase env vars in local mode.