QBOUNCE

QBounce MCP connector

Lets an AI assistant answer questions about a player's own QBounce basketball training: progress, recent sessions, shooting trends and what to practise next in the Journey. Every tool is read-only.

Connection

MCP endpoint	https://mcp.qbounce.ai/mcp (Streamable HTTP, stateless)
Authorization	OAuth 2.1 authorization code with PKCE (S256). Metadata: https://mcp.qbounce.ai/.well-known/oauth-authorization-server
Scope	qbounce.read — read the signed-in player's own training data
Tokens	Access tokens last one hour; refresh tokens rotate on every use. Revoking a refresh token (/revoke) disconnects the account.
Account	Players sign in with the account they use in the QBounce iOS app (Apple, Google or email link).

Tools

Tool	What it does	Parameters
get_progress read-only	Summarise the player's training for a period: sessions, active days, minutes, XP, shooting accuracy, dribbles, current streak and global leaderboard rank. Use for questions like 'How did I do this week?'.	period — this_week starts on Monday; last_7_days and last_30_days include today. time_zone — The player's IANA time zone, e.g. America/Chicago. Defaults to UTC.
list_recent_sessions read-only	List the player's most recent completed training sessions, newest first, with date, type, duration, XP and shooting accuracy where shots were tracked.	limit mode — Only sessions of this type. 'drills' are Journey drills. time_zone — The player's IANA time zone, e.g. America/Chicago. Defaults to UTC.
get_shooting_trend read-only	Compare shooting accuracy across the player's last N tracked shooting sessions (older half vs newer half) and report consistency. Use for 'Is my shooting improving / getting more consistent?'. Small samples are flagged.	sessions time_zone — The player's IANA time zone, e.g. America/Chicago. Defaults to UTC.
find_drills read-only	Search the QBounce Journey drill catalogue by name, skill or level, with the player's status for each drill (completed, next, or locked until earlier drills are done).	query — Words to match in the drill, level name or level goal. type — Drill type, e.g. dribbling or defense. status limit
get_next_drill read-only	The next drill in the player's Journey, with its level, goal, Journey progress and how to start it in the app. Use when the player asks what to practise next.	none

Data

Tools return only the connected player's own sessions, streak, leaderboard rank and Journey status. They never return email addresses, video, other players' data or payment information, and nothing is written to the player's account.

Support: support@qbounce.ai · Privacy policy · Terms