AI Business Assistant

story-westside-basketball-ai-assistant User Story

active user-story westside-basketball

Project

story: AI Business Assistant

Role

Admin (Marcus) — the person who runs the day-to-day business of Westside Basketball.

Key

ai-assistant

Want

As an admin, I want to manage my business by talking to Claude on my phone

So That

So that I can check schedules, track payments, send communications, and make business decisions without learning any apps or dashboards — just a conversation

Acceptance Criteria

[ ] Claude.ai on iOS can connect to basketball-api via remote MCP
[ ] Marcus can ask "What's the schedule?" and get live data from the database
[ ] Marcus can ask "Who hasn't paid?" and get real payment status
[ ] Auth is handled via Keycloak OAuth — Marcus authenticates once, Claude holds the token
[ ] MCP endpoint is HTTPS-accessible via Tailscale funnel
[ ] Safety rails are server-side (blast gates on email sends, role permissions on mutations)

Success Metric

Marcus can answer any business question by asking Claude, without opening a browser or dashboard. Zero onboarding — the "training" is "talk to Claude like you'd talk to Lucas."

Channel Architecture

This story is part of a three-channel interface strategy:

Claude.ai (this story) — the brain. Complex queries, business logic, decisions.
GroupMe — the nerve. Real-time notifications, quick coordination.
Phone browser (westside-app) — the eyes. Visual things: schedule grid, contracts, roster photos.

Each channel plays to its strength. Marcus already uses all three daily.

Staged Rollout

Hello World — one MCP tool (get_schedule), prove the transport works
Read-only business queries — schedule, roster, payments, stats
Write operations — send emails, update records (with server-side safety gates)
Full assistant — Claude can do anything Marcus can do in the admin dashboard

arch-dataflow-westside-basketball — MCP adds a new participant (claude.ai) and transport (HTTPS/SSE)
arch-deployment-westside-basketball — MCP endpoint exposed via Tailscale funnel
arch-auth-westside-basketball — OAuth flow for claude.ai MCP connector

project-westside-basketball — parent project
board-westside-basketball — execution board