FAQ — Battle Court Stats connector

Using it

Do I need to know SQL or anything technical? No. Ask questions in plain English. Claude translates them into database lookups behind the scenes. (If you want the raw data, ask "show the table" or "give me this as CSV" and Claude will include it.)

Can I break something by asking the wrong thing? No. The connection is read-only at four independent layers — neither you nor Claude can change, delete, or add anything. Worst case, a question comes back with "no results."

Why does Claude sometimes pause for a few seconds? Complex questions can require several database lookups (a full scouting report runs about seven). Normal answers land in a couple of seconds.

How current is the data? The database updates when the league's stats pipeline runs after game days. Ask "What's the most recent match date in the database?" anytime to check.

Can it predict matches or recommend bets? It has the historical data to inform that kind of thinking (head-to-heads, form, matchup stats), but it contains no odds and no prediction model. Treat anything predictive as analysis, not advice.

Why do leaderboards sometimes exclude a player I expected? Usually the minimum-attempts bar. Leaderboards apply a sensible minimum so a player with 4 lucky catches doesn't "lead" the league — say "lower the minimum to 10" if you want everyone.

A number looks wrong. What do I do? Say "double-check that — re-derive it and show the underlying numbers." Claude will re-verify against the glossary and raw counts. Still looks wrong? Tell the administrator; the underlying data may need a correction.

How specific can my questions get? Very. The database records every individual throw — who threw it, from which part of the court (inferred from where the opponent's previous ball was placed), with which hand/side, and what happened. So "kill rate on two-walls from the outside against a specific pair" is a real, answerable question. The trade-off: the more specific the scenario, the smaller the sample — Claude shows the counts so you can judge how much to trust the percentage.

Does it know other sports / other leagues / general jai alai history? The connector only contains Battle Court (WJAL) charted data from Fall 2024 onward. Claude's general knowledge fills in everything else, clearly separable from database facts — ask "is that from the database?" if unsure.

Signing in & access

Google sign-in vs password — which should I use? Whichever you like; they unlock the same access. Google is one click with nothing to remember. The password path exists for non-Google emails.

Why am I being asked to sign in again? Sessions refresh automatically while you're active. After roughly a month of not using it, you'll be asked to sign in once more. One click and you're back.

I forgot my password. Ask the administrator for a new invite link — opening it lets you set a fresh password immediately. (If your email is a Google account, you can also just use Continue with Google and skip passwords forever.)

Can I share my login with someone? Please don't — access is per-person and the administrator can add new users in seconds. Ask them.

Does it work on my phone? Yes. Connect once on web/desktop; the connector then works in the Claude mobile apps automatically.

The stats themselves

What do the ranks mean? 1 is elite, 6 is the bottom tier — lower is better. Teams can have fractional ranks (2.5) when the two players' ranks differ.

What's a rebote and why does everyone keep mentioning it? A ball played off the back wall — the hardest routine play in the sport. Rebote catch percentage separates the ranks more than any other stat (top tier ≈ 89%, bottom tier ≈ 70%).

What counts as a "kill"? A kill-shot attempt that ended the point in the thrower's favor — either untouched (a winner) or tipped but not caught. So kill rate ≥ winner rate, always.

Why does a double fault count as two faults? Charting convention: the first-serve fault and the second-serve fault are both recorded. It's intentional, and all percentages account for it.

Why are "substitution matches" excluded from player stats? When a player gets substituted mid-match, the stats can't cleanly be credited to one lineup, so skill metrics skip those matches by default. Results lists still show them, labeled. Add "include substitution matches" to any question to override.

Singles vs doubles — are they mixed together? Never. They're tracked in separate tables; Claude reports them separately and will tell you which one it's using. Singles tracking began in Winter 2025.

One letter, two meanings — I saw "C" mean two things? Sharp eye: as a throw side, C = costado (side-wall throw). As a placement, C = cortada (a kill shot into the corner). Claude knows the difference; ask for the glossary if you want the full code list.

Privacy & administration

Is what I ask private? Your questions live in your Claude conversation. The server logs only who signed in and which tools ran — never your questions or the results.

Who can see the database? Only people the administrator has explicitly added — currently a handful of named users. There is no public access.

Something's broken and I can't connect at all. Contact the administrator. (For them: status lives at /healthz, and the troubleshooting table is in the connection guide.)