# Picklemania

> Picklemania is a pickleball league, match tracking, and leaderboard platform. Public AI access is available for read-only leaderboard lookup through a remote MCP endpoint.

Use the public MCP endpoint for leaderboard questions. The server is unauthenticated, read-only, and rate-limited. In v1 it exposes a single public tool: `leaderboard_search`.

## Public MCP

- [Picklemania Public MCP endpoint](https://app.picklemania.co.uk/api/mcp): Remote MCP server using Streamable HTTP with JSON responses.
- [Picklemania MCP discovery JSON](https://app.picklemania.co.uk/api/mcp/discovery): Tool metadata, supported filters, examples, and endpoint details.

## Available tool

- [leaderboard_search](https://app.picklemania.co.uk/api/mcp/discovery): Search Picklemania's public matches/ELO leaderboard. Supported filters: `global`, `clubId`, `clubName`, `playerLevel`, `gender`, `ageMin`, `ageMax`, `dateWindow`, `limit`, and `cursor`.

## Examples

- [Who's leading Picklemania leaderboards this week?](https://app.picklemania.co.uk/api/mcp/discovery): Use `leaderboard_search` with `dateWindow = "last-7-days"` and `limit = 10`.
- [Show the top advanced players globally this month.](https://app.picklemania.co.uk/api/mcp/discovery): Use `global = true`, `playerLevel = "Advanced"`, and `dateWindow = "last-30-days"`.
- [Show the top players for Manchester Pickleball Club this year.](https://app.picklemania.co.uk/api/mcp/discovery): Use `clubName = "Manchester Pickleball Club"` and `dateWindow = "this-year"`.

## Optional

- [Main website](https://picklemania.co.uk/)
- [App signup](https://app.picklemania.co.uk/signup)