Padel matches for people and agents: create, share one link, join, americano schedules, levels.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
What Kicksmash is and how to use it: matches, levels, groups, boards, the API and what we ask of assistants. Read this once before acting.
This tool takes no arguments.
What Kicksmash is and how to use it: matches, levels, groups, boards, the API and what we ask of assistants. Read this once before acting.
No arguments.
{
"type": "object",
"properties": {}
}Book one lesson at a free start for an accepted student (their personal token). Draws from their open package when they have one. Confirm the time with the person first.
| Argument | Type | Description |
|---|---|---|
| token* | string | The student's personal token (from request_coach or any earlier call). The coach must have accepted them. |
| handle* | string | The coach's handle from their page URL, e.g. 'olga' in kicksma.sh/c/olga. |
| startsAt* | string | A start from coach_slots, ISO 8601. |
{
"type": "object",
"required": [
"handle",
"token",
"startsAt"
],
"properties": {
"token": {
"type": "string",
"maxLength": 64,
"minLength": 8,
"description": "The student's personal token (from request_coach or any earlier call). The coach must have accepted them."
},
"handle": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "The coach's handle from their page URL, e.g. 'olga' in kicksma.sh/c/olga."
},
"startsAt": {
"type": "string",
"minLength": 10,
"description": "A start from coach_slots, ISO 8601."
}
}
}Cancel a student's lesson under the coach's rules; the outcome says whether it was refunded, covered by a free pass, or counted. Say the rule to the person before cancelling late.
| Argument | Type | Description |
|---|---|---|
| token* | string | The student's personal token. |
| lessonId* | string | The lesson id from book_lesson. |
{
"type": "object",
"required": [
"lessonId",
"token"
],
"properties": {
"token": {
"type": "string",
"maxLength": 64,
"minLength": 8,
"description": "The student's personal token."
},
"lessonId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The lesson id from book_lesson."
}
}
}Free starts inside a coach's hours for the next days (default 14). Only accepted students can book them: request_coach first.
| Argument | Type | Description |
|---|---|---|
| days | integer | How many days ahead, default 14. |
| handle* | string | The coach's handle from their page URL, e.g. 'olga' in kicksma.sh/c/olga. |
{
"type": "object",
"required": [
"handle"
],
"properties": {
"days": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "How many days ahead, default 14."
},
"handle": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "The coach's handle from their page URL, e.g. 'olga' in kicksma.sh/c/olga."
}
}
}Get a free key instantly for roomier limits and webhooks. Shown once. Not needed for reading or for a few writes a day.
| Argument | Type | Description |
|---|---|---|
| name* | string | Who or what will use the key. |
| agent | string | Your name as an assistant, e.g. 'claude'. |
| string |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Who or what will use the key."
},
"agent": {
"type": "string",
"maxLength": 80,
"description": "Your name as an assistant, e.g. 'claude'."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
}
}
}Create a padel match (4 players) or an americano tournament for a person. A tournament may keep fixed pairs (fixedPairs: true): two partners play every round together and the table ranks pairs. Returns the share link for the players and the organizer's private links. Give the person all links; keep personalToken and manageUrl private. Ask before creating; one request, one match.
| Argument | Type | Description |
|---|---|---|
| tz* | string | IANA time zone the players live in, for example Asia/Singapore or Asia/Bangkok. |
| cost | string | What each player pays, as free text: 400 THB, €8, split 4 ways. |
| note | string | |
| type | string | A match is exactly four players. A tournament is an americano with 4 to 64 players in fours. |
| court | string | Court within the venue, e.g. "3". |
| title | string | |
| venue | string | Club or court name. Enables the venue board and the booking link. |
| ageMin | any | An age tag: 35, 45 or 55 means 35+, 45+ or 55+. Omit for any age. Information only; nobody is checked when they join. |
| format |
Padel clubs: booking link and platform, courts, today's free courts (from the club's own calendar feed, or read from its booking platform's public page: freeCourts.source says which, and freeCourts.platform names it), founding status. Every row says `claimed`: true when the club runs the page itself, false when Kicksmash listed it from public sources, where the courts and links are our reading and may be out of date. Pass include:'listed' to get both — that is what answers "where can I play here?". Filter by city (phuket, singapore) or ask for one club by name.
| Argument | Type | Description |
|---|---|---|
| city | string | phuket or singapore |
| name | string | One club by name; the slug is derived |
| include | string | claimed (default): only clubs that run their own page. listed: also the clubs Kicksmash listed from public sources, each marked claimed:false. |
{
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 40,
"description": "phuket or singapore"
},
"name": {
"type": "string",
"maxLength": 80,
"description": "One club by name; the slug is derived"
},
"include": {
"enum": [
"claimed",
"listed"
],
"type": "string",
"description": "claimed (default): only clubs that run their own page. listed: also the clubs Kicksmash listed from public sources, each marked claimed:false."
}
}
}Padel coaches who listed their page: clubs, lesson length, languages, the rules students book under (cancellation cutoff, free late passes, notice). Filter by city. Prices are the coach's to tell; nothing is paid through Kicksmash.
| Argument | Type | Description |
|---|---|---|
| city | string | phuket or singapore; omit for every listed coach |
{
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 40,
"description": "phuket or singapore; omit for every listed coach"
}
}
}Open, organizer-listed matches at a venue (its public board), with spots left and level ranges. Give the venue name; the slug is derived.
| Argument | Type | Description |
|---|---|---|
| venue* | string | Venue name or its slug, e.g. 'Padel Indoor BCN' or 'padel-indoor-bcn'. |
{
"type": "object",
"required": [
"venue"
],
"properties": {
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name or its slug, e.g. 'Padel Indoor BCN' or 'padel-indoor-bcn'."
}
}
}Tournament series: same weekday and time every week, fortnight or month, with the next edition to sign up for and the past podiums. Filter by city, or pass a slug for one series. Players sign up on the edition's match page.
| Argument | Type | Description |
|---|---|---|
| city | string | phuket or singapore; omit for every active series |
| slug | string | One series by slug: its next edition and past podiums |
{
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 40,
"description": "phuket or singapore; omit for every active series"
},
"slug": {
"type": "string",
"maxLength": 60,
"description": "One series by slug: its next edition and past podiums"
}
}
}Rounds of rotating-partner doubles for 4 to 64 players. Exact when the field is in fours (every pair partners once in players−1 rounds), fair sit-outs otherwise. Nothing is stored.
| Argument | Type | Description |
|---|---|---|
| seed | integer | Same seed, same schedule. |
| names | array | |
| courts | integer | Defaults to floor(players / 4). |
| format | string | |
| rounds | integer | Defaults to players − 1 when the field is in fours (every pair partners once), else players. |
| players | integer | Number of players; ignored when names are given. |
{
"type": "object",
"properties": {
"seed": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Same seed, same schedule."
},
"names": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"maxItems": 64,
"minItems": 4
},
"courts": {
"type": "integer",
"maximum": 16,
"minimum": 1,
"description": "Defaults to floor(players / 4)."
},
"format": {
"enum": [
"americano"
],
"type": "string",
"default": "americano"
},
"rounds": {
"type": "integer",
"maximum": 40,
"minimum": 1,
"description": "Defaults to players − 1 when the field is in fours (every pair partners once), else players."
},
"players": {
"type": "integer",
"maximum": 64,
"minimum": 4,
"description": "Number of players; ignored when names are given."
}
}
}A crew that plays together: members' first names and count (their levels are for members only, so null here), weekly slot, whether it asks to join, upcoming matches, calendar feed.
| Argument | Type | Description |
|---|---|---|
| code* | string | The code from the link. |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 6,
"minLength": 4,
"description": "The code from the link."
}
}
}A match or tournament by its 4-character code: players with levels, spots left, venue, time, level range, result. Public data only.
| Argument | Type | Description |
|---|---|---|
| code* | string | The code from the link. |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 6,
"minLength": 4,
"description": "The code from the link."
}
}
}Put a person into a match by first name (or by their personal token from an earlier call). Handles waitlists and level ranges; when the level is outside the range, the organizer is asked to approve, unless the player already played a finished, scored match with that organizer. On a fixed-pairs tournament pass partner (a first name) to sign up as a pair: the answer's partner.inviteUrl is the link the partner opens to claim their spot; without partner the person is listed as needing a partner. For a group's match the answer says whether the person is now a member of the group; a group that asks to join is never joined through a match. A place the organizer holds for the same name refuses the join (name_held) and writes nothing: if it is that person, they take the place on the match page; if not, they join with a fuller name, such as a last name. A name (with no token) that a player already in the match carries refuses the join (name_seated) and writes nothing: if it is that player, call again with their personal token; if not, join with a fuller name.
| Argument | Type | Description |
|---|---|---|
| code* | string | The 4-character match code from the link, e.g. kicksma.sh/AB12 → AB12. |
| name | string | Required unless token is given. |
| string | Optional. Sends a calendar invite that updates itself. | |
| level | number | Needed once when the match has a level range and the player has no level yet. |
| token | string | Personal token of an existing player. |
| partner |
Ask a coach to accept a person as their student, by first name or personal token. The coach answers with one tap. Keep the returned personalToken private to the student; book_lesson needs it. Ask the person before calling.
| Argument | Type | Description |
|---|---|---|
| name | string | The student's first name. Required unless token is given. |
| token | string | Personal token of an existing Kicksmash player. |
| handle* | string | The coach's handle from their page URL, e.g. 'olga' in kicksma.sh/c/olga. |
{
"type": "object",
"required": [
"handle"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "The student's first name. Required unless token is given."
},
"token": {
"type": "string",
"maxLength": 64,
"minLength": 8,
"description": "Personal token of an existing Kicksmash player."
},
"handle": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "The coach's handle from their page URL, e.g. 'olga' in kicksma.sh/c/olga."
}
}
}| string |
| Tournaments only. americano: partners rotate, everyone plays everyone. mexicano: courts by standings after round 1. king: winners move up a court, losers down. |
| gamesTo | integer | Tournaments only: first to N games (4, 6, 8) instead of points; the table then ranks by matches won. |
| capacity | integer | Tournaments only, a multiple of 4. Matches are always 4. |
| category | any | Who the match is for: men, women or mixed. Omit for anyone. Information for the players who find it; nobody is checked when they join. |
| levelMax | any |
| levelMin | any | Level range 0 to 7 (Playtomic-style). Omit both for any level. |
| startsAt* | string | ISO 8601 date-time. With an offset or Z it is absolute; without one it is read in tz. Example: 2026-09-11T19:00 |
| whenFull | string |
| organizer* | object |
| bookingUrl | string | The club's booking page or confirmation link, shown to players. |
| fixedPairs | boolean | Tournaments only: two partners play every round together, in any format. Pairs sign up together (join_match with partner); a player alone is listed as needing a partner. Americano then rotates the opponents: every pair meets every other pair, and the table ranks pairs. |
| venueMapUrl | string |
| organizerPlays | boolean | Seat the organizer in the match (default). False when they only organize. |
| pointsPerMatch | integer | Tournaments only: fixed points per match (16, 21, 24, 32). Omit for free scoring; mexicano defaults to 24. |
| durationMinutes | number | How long the court is booked: 60, 90 or 120 minutes. Omit for 90 (a match) or 120 (a tournament). The match page, the cards and the calendar invitation show it. |
| listOnVenueBoard | boolean | Show the match on the public venue board (/v/{venue-slug}). Off by default. |
| verifiedLevelsOnly | boolean | With a range: only levels confirmed by an organizer, a coach or a club walk in; declared levels inside the range ask to join. |
{
"type": "object",
"required": [
"startsAt",
"tz",
"organizer"
],
"properties": {
"tz": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "IANA time zone the players live in, for example Asia/Singapore or Asia/Bangkok."
},
"cost": {
"type": "string",
"maxLength": 40,
"description": "What each player pays, as free text: 400 THB, €8, split 4 ways."
},
"note": {
"type": "string",
"maxLength": 500
},
"type": {
"enum": [
"match",
"tournament"
],
"type": "string",
"default": "match",
"description": "A match is exactly four players. A tournament is an americano with 4 to 64 players in fours."
},
"court": {
"type": "string",
"maxLength": 40,
"description": "Court within the venue, e.g. \"3\"."
},
"title": {
"type": "string",
"maxLength": 80
},
"venue": {
"type": "string",
"maxLength": 80,
"description": "Club or court name. Enables the venue board and the booking link."
},
"ageMin": {
"anyOf": [
{
"enum": [
35,
45,
55
],
"type": "number"
},
{
"type": "null"
}
],
"description": "An age tag: 35, 45 or 55 means 35+, 45+ or 55+. Omit for any age. Information only; nobody is checked when they join."
},
"format": {
"enum": [
"americano",
"mexicano",
"king"
],
"type": "string",
"description": "Tournaments only. americano: partners rotate, everyone plays everyone. mexicano: courts by standings after round 1. king: winners move up a court, losers down."
},
"gamesTo": {
"type": "integer",
"maximum": 12,
"minimum": 2,
"description": "Tournaments only: first to N games (4, 6, 8) instead of points; the table then ranks by matches won."
},
"capacity": {
"type": "integer",
"maximum": 64,
"minimum": 4,
"description": "Tournaments only, a multiple of 4. Matches are always 4."
},
"category": {
"anyOf": [
{
"enum": [
"men",
"women",
"mixed"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Who the match is for: men, women or mixed. Omit for anyone. Information for the players who find it; nobody is checked when they join."
},
"levelMax": {
"anyOf": [
{
"type": "number",
"maximum": 7,
"minimum": 0
},
{
"type": "null"
}
]
},
"levelMin": {
"anyOf": [
{
"type": "number",
"maximum": 7,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Level range 0 to 7 (Playtomic-style). Omit both for any level."
},
"startsAt": {
"type": "string",
"maxLength": 40,
"minLength": 10,
"description": "ISO 8601 date-time. With an offset or Z it is absolute; without one it is read in tz. Example: 2026-09-11T19:00"
},
"whenFull": {
"enum": [
"waitlist",
"closed"
],
"type": "string",
"default": "waitlist"
},
"organizer": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "First name is enough."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Optional. Gets the organizer link and calendar invite by email."
},
"level": {
"type": "number",
"maximum": 7,
"minimum": 0
},
"token": {
"type": "string",
"maxLength": 64,
"minLength": 8,
"description": "Personal token of an existing Kicksmash player, returned by earlier calls, so the same person organizes again."
}
}
},
"bookingUrl": {
"type": "string",
"format": "uri",
"maxLength": 500,
"description": "The club's booking page or confirmation link, shown to players."
},
"fixedPairs": {
"type": "boolean",
"default": false,
"description": "Tournaments only: two partners play every round together, in any format. Pairs sign up together (join_match with partner); a player alone is listed as needing a partner. Americano then rotates the opponents: every pair meets every other pair, and the table ranks pairs."
},
"venueMapUrl": {
"type": "string",
"format": "uri",
"maxLength": 500
},
"organizerPlays": {
"type": "boolean",
"default": true,
"description": "Seat the organizer in the match (default). False when they only organize."
},
"pointsPerMatch": {
"type": "integer",
"maximum": 99,
"minimum": 4,
"description": "Tournaments only: fixed points per match (16, 21, 24, 32). Omit for free scoring; mexicano defaults to 24."
},
"durationMinutes": {
"enum": [
60,
90,
120
],
"type": "number",
"description": "How long the court is booked: 60, 90 or 120 minutes. Omit for 90 (a match) or 120 (a tournament). The match page, the cards and the calendar invitation show it."
},
"listOnVenueBoard": {
"type": "boolean",
"default": false,
"description": "Show the match on the public venue board (/v/{venue-slug}). Off by default."
},
"verifiedLevelsOnly": {
"type": "boolean",
"default": false,
"description": "With a range: only levels confirmed by an organizer, a coach or a club walk in; declared levels inside the range ask to join."
}
}
}| string |
| A fixed-pairs tournament only: the partner's first name. Their spot is reserved with its own invite link (partner.inviteUrl in the answer), which the partner opens to claim it. Omit to join alone: the player is listed as needing a partner. A player already in alone may call again with a partner. |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 4,
"minLength": 4,
"description": "The 4-character match code from the link, e.g. kicksma.sh/AB12 → AB12."
},
"name": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Required unless token is given."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Optional. Sends a calendar invite that updates itself."
},
"level": {
"type": "number",
"maximum": 7,
"minimum": 0,
"description": "Needed once when the match has a level range and the player has no level yet."
},
"token": {
"type": "string",
"maxLength": 64,
"minLength": 8,
"description": "Personal token of an existing player."
},
"partner": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "A fixed-pairs tournament only: the partner's first name. Their spot is reserved with its own invite link (partner.inviteUrl in the answer), which the partner opens to claim it. Omit to join alone: the player is listed as needing a partner. A player already in alone may call again with a partner."
}
}
}