Basketball Assistant

The whole club in one calendar: every team's practices, games and other events plus the club-level ones (parent meetings, socials) and the blackout periods, for anyone in the organization (next 30 days by default; days_ahead up to 365, whole_season, from_date for a later window; team_ids and types to filter). Renders an interactive Club Calendar with a colour per team, team and type filters, and — for the owner and admins — a form for club-level events. Omit organization_id when you belong to one club.

get_club_calendar

Get a competition session with entrants, results, and live standings. While the session is open, it also returns the session's on-court runner link — the same link on every call until it nears expiry, when a new one is minted. Use it to reopen the runner on any phone.

get_competition_session

List a team’s competition sessions (newest first), optionally by status. Use get_competition_session for standings and the runner link.

list_competition_sessions

Clone an existing practice plan (your own or a public one). Creates a draft copy that you can modify. Completed plans clone too: the copy is a new, active plan.

clone_practice_plan

Create a new drill combo (admin only). Creates in draft status; publish separately.

create_drill_combo

Create a new organization (requires authentication)

create_organization

Create a shareable invite link so someone can join the organization with a given role, even if they don't have an account yet. Owners/admins only. Supports an email restriction, a usage limit, and an expiry. Returns a /join/<code> share URL.

create_organization_invite

Create a team inside an organization — for coaches managing multiple teams under one org. Requires authentication and a coach/admin/owner role. For a single standalone team, use create_team instead.

create_organization_team

Create a new practice plan with optional segments. Returns the plan with computed duration and focus breakdowns. LIBRARY-FIRST: For best results, build plans using library content: - Use search_all to find drills before adding drill segments - Consider search_drill_combos for skill progressions (better than individual drills) - Set linked_drill_id/linked_play_id on segments to connect to library content - Use is_custom: true only for team-specific activities not in the library WORKFLOW: 1. generate_practice_plan for AI-assisted draft (auto-searches library) 2. Or manually: search_all → add segments with linked IDs 3. Use add_combo_to_practice_plan for curated skill progressions

create_practice_plan

Create a standalone basketball team (no organization required) — the default for volunteer coaches managing a single team. For organization-based teams (managing several teams together), use create_organization_team instead.

create_team

Create a player's individual training plan (coach only). Each player has exactly ONE current plan — if one exists, use update_training_plan instead (it keeps a revision history). Items can link library drills (kind: "drill") or be free-form (kind: "custom"); max 8 items, 6 fits on one printed page. Tip: generate_training_plan drafts one automatically from the team's training pool.

create_training_plan

Permanently delete your account and personal data (GDPR erasure). Irreversible. Requires the confirmation phrase "delete my account" — always confirm with the user before calling. Sole owners of organizations with other members must transfer ownership first.

delete_account

Delete a competition session and its results (coach only). The team leaderboard recomputes without it. This cannot be undone.

delete_competition_session

Delete one of your saved diagrams. This cannot be undone (share links to it stop working).

delete_diagram

Delete a team (requires authentication and owner/admin role)

delete_team

Delete a tournament and all its rounds, entrants, and results (creator only). This cannot be undone.

delete_tournament

Delete a player’s individual training plan and its revision history (coach only). This cannot be undone.

delete_training_plan

Validate and render a basketball court diagram (diagrams-spec-v1 JSON) to SVG — the live preview behind the Diagram Creator. Use it to draw drill setups, play actions, or teaching diagrams from a conversation ("draw me a 3-cone weave on a half court"): build the spec, render, fix any validation errors it reports, and iterate. Per-step specs return every step's SVG in one call. Nothing is stored — keep a diagram with save_diagram.

render_diagram

Get full details of a drill combo including all drills in sequence, coaching notes, transitions, and rating summary. Look up by combo_slug (PREFERRED) or combo_id. A "(slug: …)" combo reference in the conversation goes straight into combo_slug — no search round trip. Draft combos are visible only to their creator. USE THIS BEFORE ADDING COMBO TO PLAN: - Preview the full drill sequence - Review coaching notes and transition tips - Check expected outcomes and difficulty progression - See rating summary from other coaches RESPONSE INCLUDES: drills (ordered), coaching_notes, transition_tips, expected_outcomes, rating_summary WORKFLOW: 1. search_drill_combos finds matching combos 2. get_drill_combo_details to inspect before adding 3. add_combo_to_practice_plan to insert into practice

get_drill_combo_details

List drill combos with optional filters. Returns summary info without full drill details.

list_drill_combos

Get full drill details including instructions, coaching points, common errors, and variations. Look up by drill_slug (PREFERRED) or drill_id. WHEN TO USE: - The message asks to show/open a drill and gives a slug, e.g. 'the drill details for "Dribble Tag" (slug: dribble-tag)' → call THIS tool directly with drill_slug — do NOT call search_all first (a SEARCH request like 'find similar drills' still goes to search_all) - After search_all → call with the slug from its Refs block as drill_slug - Before presenting drill info to coach → get full coaching content - Building practice plan artifacts → need complete instructions RESPONSE INCLUDES: Full instructions, coaching emphasis, common errors, variations, duration, equipment, space requirements. MCP UI: Response includes metadata.mcp_ui.template_uri for drill card rendering, in the user's Pro Baller or Street Baller style. WORKFLOW WITH PRACTICE PLANS: search_all finds drill → get_drill_details (by slug) for coaching content → add_practice_segment with linked_drill_id

get_drill_details

Get aggregated ratings for a drill. Returns average rating, breakdown by skill level and age group, and common feedback tags. Individual ratings are not exposed for privacy.

get_drill_ratings

Export the personal data Basketball Assistant stores about your account as structured JSON (profile, organizations, teams, players, attendance, practice plans, ratings). GDPR data access. Roster details coaches keep privately are not included in the chat; the result says how to get a complete copy.

export_my_data

Find on-court basketball competitions (Layup 60s, Around the World, Killer, team relays, …) and link to their public runner pages. Each link opens an interactive page anyone can use on a phone at the court — timers, hit/miss scoring, knockout wheels — with NO account needed; results stay on the device. Works for teams at practice, a player on the driveway, or friends at the park. Filter by where it's played, group size, and the group's age band. Share the returned URLs directly.

find_competitions

Mint a fresh Game Center link for a tournament. Default = SCORER link (run rounds + post results). Set read_only: true for the PLAYERS link (live standings, rules, prizes — view only). No account needed either way; standings sync to everyone holding any link.

get_tournament_link

AI-assisted practice plan generation. Automatically searches the drill library matching focus areas and the group's age and skill level, builds a structured draft plan with linked library drills. Describe the group with age_group + skill_level, or pass team_id to use the context of one of the coach's teams instead. HOW IT WORKS: 1. Searches the library once per focus area (matching the group's skill level/age) and shares the drill slots between the areas 2. Builds draft with warmup, main drills grouped by focus area (linked to library), a water break about every 20 minutes, a scrimmage finisher (sessions 45 min and up), and a short cooldown 3. Returns draft segments with linked_drill_id populated from search results — the refs carry the save-ready practice_segments and each drill's id + slug 4. Coach reviews draft, then save with create_practice_plan (pass the refs' practice_segments) AFTER GENERATION: - Review the drills in the refs to see what was found - Use get_drill_details on any drill for full instructions/coaching points - Consider replacing individual drills with drill combos for better progression COMBO ALTERNATIVE: For focused skill sessions, search_drill_combos + add_combo_to_practice_plan may provide better curated progressions than AI generation.

generate_practice_plan

AI-draft an individual training plan for a player (coach only). Picks drills from the team's training pool first (get_training_pool), pads from the drill library matching focus areas + team age/skill (another level only when nothing at the team's level fits an area), and sizes the session to the target duration (~6 exercises max — one printed page). Every focus area gets at least one exercise; when no drill fits an area, the draft holds a placeholder exercise for it instead of failing. The setting shapes the draft: with hoop false, drills that need a hoop are left out; library drills that need a partner are left out unless training_partner is true; drills that use the equipment named (e.g. cones) come first. Ask the coach these questions only when they matter to them. The draft is NOT saved. Review/tweak, then save with create_training_plan (or update_training_plan if the player already has one — the old version stays in the change register). The refs carry the save-ready items with their drill ids. Up to 30 AI drafts a month; manual editing is always unlimited.

generate_training_plan

Get personalized welcome message with getting started instructions. Shows setup status, next steps, and feature overview tailored to user role and configuration state. Perfect for first-time users and as a quick reference guide.

get_welcome_message

Join an organization using an invite code. Binds the membership to the signed-in user and grants the invite's role. Idempotent — re-redeeming does nothing if already a member.

redeem_organization_invite

Mark an event as completed. A completed practice's linked practice plan then counts as completed and leaves the default plan list.

complete_event

Open a saved diagram (yours, or one shared with your organization) in the Diagram Creator with its cached SVG.

get_diagram

Get the link to the team's full roster page on the Basketball Assistant website (team staff only). The page shows the full roster with attendance rates and each player's account, parent and training-plan status, and is where coaches manage roster details beyond name, jersey number and position. Use it when a coach asks for the full roster page. The page asks the coach to sign in with their Basketball Assistant account, and only the team's coaching staff can open it.

open_roster_page

Aggregated attendance report across all teams in the organization

get_organization_attendance_report

Cross-team overview for organization admins: teams, members, plans, upcoming events. Renders an interactive Org Dashboard (KPIs, team grid, create team, and links to members / attendance / plans).

get_organization_dashboard

Get organization details (requires authentication and membership)

get_organization

List an organization's invite links (owners/admins only). Set include_inactive to also show revoked/expired ones.

list_organization_invites

Get all members of an organization (requires authentication and membership)

get_organization_members

View all practice plans across the organization

get_organization_practice_plans

Get organization coaching preferences including philosophy, preferred offensive/defensive systems, and play style tags

get_organization_preferences

Get overview of all teams in organization with alignment status. Shows which teams have custom preferences vs using org defaults, and which teams are fully configured.

get_organization_teams_overview