What this MCP does
Supports organizing padel matches and tournaments, finding clubs and coaches, joining matches, booking lessons and generating Americano schedules.
Capabilities
Tools
15
tools
about_kicksmash
About Kicksmash
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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
book_lesson
Book a lesson
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.
Input schema
{'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_lesson
Cancel a lesson
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.
Input schema
{'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.'}}}
coach_slots
A coach's free times
Free starts inside a coach's hours for the next days (default 14). Only accepted students can book them: request_coach first.
Read only
Idempotent
Input schema
{'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."}}}
create_api_key
Create an API key
Get a free key instantly for roomier limits and webhooks. Shown once. Not needed for reading or for a few writes a day.
Input schema
{'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_match
Create a match
Create a padel match (4 players) or an americano tournament for a person. 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.
Input schema
{'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.'}, '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.'}, '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."}, '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.'}}}
find_clubs
Find clubs
Padel clubs: booking link and platform, courts, today's free courts when the club shares its calendar, 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.
Read only
Idempotent
Input schema
{'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.'}}}
find_coaches
Find coaches
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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'city': {'type': 'string', 'maxLength': 40, 'description': 'phuket or singapore; omit for every listed coach'}}}
find_matches
Find open matches at a venue
Open, organizer-listed matches at a venue (its public board), with spots left and level ranges. Give the venue name; the slug is derived.
Read only
Idempotent
Input schema
{'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'."}}}
find_series
Find series (Opens that repeat)
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.
Read only
Idempotent
Input schema
{'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'}}}
generate_schedule
Generate an americano schedule
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.
Read only
Idempotent
Input schema
{'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.'}}}
get_group
Get a group
A crew that plays together: members with levels, weekly slot, upcoming matches, calendar feed.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'maxLength': 6, 'minLength': 4, 'description': 'The code from the link.'}}}
get_match
Get a match
A match or tournament by its 4-character code: players with levels, spots left, venue, time, level range, result. Public data only.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'maxLength': 6, 'minLength': 4, 'description': 'The code from the link.'}}}
join_match
Join a match
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.
Input schema
{'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.'}}}
request_coach
Ask to become a student
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.
Input schema
{'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."}}}
History
Recent tool changes
Changed
create_match
Oct. 1, 2026, 2:51 a.m.
Changed
find_clubs
Sept. 23, 2026, 2:50 a.m.
Changed
create_match
Sept. 21, 2026, 2:57 a.m.
Added
create_api_key
Sept. 17, 2026, 12:55 p.m.
Added
join_match
Sept. 17, 2026, 12:55 p.m.
Added
create_match
Sept. 17, 2026, 12:55 p.m.
Added
cancel_lesson
Sept. 17, 2026, 12:55 p.m.
Added
book_lesson
Sept. 17, 2026, 12:55 p.m.
Added
request_coach
Sept. 17, 2026, 12:55 p.m.
Added
coach_slots
Sept. 17, 2026, 12:55 p.m.
Added
find_coaches
Sept. 17, 2026, 12:55 p.m.
Added
find_series
Sept. 17, 2026, 12:55 p.m.
Added
find_clubs
Sept. 17, 2026, 12:55 p.m.
Added
generate_schedule
Sept. 17, 2026, 12:55 p.m.
Added
get_group
Sept. 17, 2026, 12:55 p.m.
Added
find_matches
Sept. 17, 2026, 12:55 p.m.
Added
get_match
Sept. 17, 2026, 12:55 p.m.
Added
about_kicksmash
Sept. 17, 2026, 12:55 p.m.
Discover
Similar MCP servers
Asterwise
com.asterwise/mcp
Provides Vedic and Western astrology, numerology, tarot, dream-symbol, crystal, compatibility, and related esoteric calculations …
Vedic Astrology and Kundli MCP Server by RoxyAPI
com.roxyapi/vedic-astrology
Calculates and explains Vedic astrology charts, planetary positions, dashas, nakshatras, yogas, doshas, aspects, compatibility, a…
Sahadeva
io.github.everyai-com/sahadeva
Calculates and analyzes Vedic astrology charts, compatibility, dashas, transits, yogas, remedies, and evidence or readiness check…
tollbooth-sample
io.github.lonniev/tollbooth-sample
Provides current, forecast, and historical weather data alongside Lightning-based usage credits, pricing, coupons, balances, and …
Thesportsdb
io.github.pipeworx-io/thesportsdb
Provides sports catalog and match data, including teams, players, leagues, schedules, standings, lineups, timelines, scores, and …
Rescuegroups
io.github.pipeworx-io/rescuegroups
Searches adoptable animals, breeds, rescues, shelters, and organization details from RescueGroups.org.
Recipes
io.github.pipeworx-io/recipes
Provides meal and recipe discovery by ingredient, random selection, and detailed cooking instructions.
F1
io.github.pipeworx-io/f1
Provides Formula 1 schedules, race results, driver profiles, and current championship standings.