accept_game_participation
ChatGPTAccept the signed-in golfer's invitation to one game. Requires the exact tee-time ID; joining is not a booking. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
add_course_to_list
ChatGPTAdd a course to one of your course lists. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
cancel_booking
ChatGPTCancel only on explicit request and verify the result. Use hold_id, or ForeUp course_id plus confirmation_number; never both. Uncertain: get_booking_status, never repeat cancellation. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
cancel_my_game
ChatGPTCancel an owned game. Brief outcome; show refreshed dashboard once without repeating rows. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
change_game_participation
ChatGPTAccept, decline, or leave a game. Confirmed slots use persisted Group 1 unless assigned; leaving may include a comment. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
confirm_booking
ChatGPTSubmit the current held review only after approval. Requires approved:true and current review_id. Unknown: get_booking_status, never repeat submission. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
confirm_game_participant
ChatGPTConfirm one invited golfer in an owned game. Requires the exact tee-time and slot IDs; refresh the dashboard once. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
create_alert
ChatGPTCreate an SMS golf alert for one course or a saved list_id. For lists, show the returned preview, obtain confirmation, reuse creation_request_id, then confirm:true. After creation refresh list_my_alerts once. Reuse the account-verified phone. On consent_required, show its disclosure and obtain explicit consent. On availability_warning, ask before confirm:true. Preserve continuation arguments and creation_request_id when retrying or resuming verification; do not reselect the course. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
create_hosted_event
ChatGPTCreate a hosted golf event. Provide the tee/start time; end_time is optional and defaults to four hours later. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
create_my_course_list
ChatGPTCreate an empty named course list for the signed-in golfer, then add courses with add_course_to_list. Do not automatically retry creation. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
create_my_game
ChatGPTCreate game. Ask only missing details; retain resolved IDs and args. If course_selection_required, call show_game_course_picker with its selection_token. Never re-search. When details are missing, offer actual invitation_options groups as numbered options with names and member counts in the same question; resolve an option number using the displayed group IDs, never as a group ID; individual golfers or no invitations are also valid. Preserve invitationPlan, dates, holes and playerLimit separately. Resolve exclusions/individuals with real IDs; clarify ambiguity. Never claim invitations succeeded unless invitation_result confirms it. If invitations fail after creation, retry invites only, never creation. After conversational creation succeeds and invitations finish, call list_my_dashboard_tee_times once with scope upcoming to show the new game in My Games; this tool has no registered UI. Never create again to display the result. No replacement forms.
create_my_group
ChatGPTCreate a player group. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
decline_game_participation
ChatGPTDecline the signed-in golfer's invitation to one game. Requires the exact tee-time ID and never books a tee time. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
delete_alert
ChatGPTCancel one of your golf alerts after explicit confirmation. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
delete_my_course_list
ChatGPTDelete a course list. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
delete_my_game
ChatGPTDelete an owned game after confirmation. Brief outcome; show refreshed dashboard once without repeating rows. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
delete_my_group
ChatGPTDelete an owned player group after confirmation; removes only the group record. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
exclude_alert_course
ChatGPTExclude one course from a list watch; the saved list and parent watch remain. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
get_booking_skill
ChatGPTAuthenticated, versioned booking guidance. On an explicit Direct Book tap or chat booking request, fetch if missing/stale versus booking_skill_version. Silently use/update locally if supported; no separate install prompt. Fetch failure or unsupported vendor: course website. Credentials stay server-side.
get_booking_status
ChatGPTCheck or revalidate an attempt. ForeUp unknown may start one fresh hold; repeated status on the original ID follows its replacement. Never repeats final booking. May resume preparation or refresh expiry. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
get_golfer
ChatGPTGet a golfer.
get_my_alert
ChatGPTShow one of the signed-in golfer's alerts for a tee-time opening or public hosted game. Returns the selected alert's course, date range, time window, player count, recurrence, category, status, fatigue state, and matched-slot snapshot. If phone verification is required, call request_phone_verification, tell the golfer to check their phone and provide the code, then call verify_phone_code; do not expose a full phone number in the response. When the alerts widget renders, acknowledge briefly without repeating alert rows; if unavailable, summarize the result in text. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
get_my_course_list
ChatGPTShow courses in one named collection; widget-first with compact fallback. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
get_my_dashboard
ChatGPTMy Dashboard: "Show my dashboard", "Show my golf dashboard", "Show my golf life", "Show Primo dashboard". Sections: My Games; Join a Game; Course Lists; Groups; Alerts; My Reservations; What can Primo do? App/text. See core/primo-game-workflows.md. summary_only: one brief acknowledgment, then stop; no duplicate UI/rows/questions/subsets. Missing _meta/render ack is not failure evidence. Text on request, explicit failure or server fallback; preserve errors/confirmations.
get_my_dashboard_tee_time
ChatGPTResolve signed-in game. Full widget records are in _meta.primo.widgetData; use the summary. If unavailable, summarize. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
get_my_profile
ChatGPTShow the signed-in golfer's profile: name, nickname, avatar, ZIP, gender, birth date, bio, GHIN, and handicap. Use for ‘show my profile’ or ‘show my golf profile’. Read-only; profile:read. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
get_primo_agent_instructions
ChatGPTFetch the Primo agent instructions once per session before a Primo golf job. Follow its search, presentation, booking, game, invite, and alert rules.
get_primo_capabilities
ChatGPTOpen the PRIMO onboarding widget for introductory questions: "What can Primo do?", "How can Primo help me play more golf?", "Help me play more golf", or general help. Call this tool rather than answering from memory or opening the website. Use direct tools for specific golf requests. For explicit PRIMO version/build questions, call this tool live and report server_build (version, commit, deployment_id, environment); do not confuse it with the AI model version. For onboarding questions, let the widget present the capabilities with a brief acknowledgment. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
hold_tee_time
ChatGPTLoad get_booking_skill. Prepare the selected slot and priced review; nothing is booked. Reuse hold_id for gates. ForeUp same-slot retry archives the prior unknown and prepares a fresh vendor hold. Other unknowns: get_booking_status. Never repeat final submission. No credentials in chat. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
invite_golfers
ChatGPTInvite selected golfers; new slots use persisted Group 1 unless groupNumber is explicit. Refresh once. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
join_hosted_game
ChatGPTJoin a public game after confirm; commit to show up. Course games auto-confirm; individual games need approval. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
leave_game_participation
ChatGPTLeave a game the signed-in golfer joined. Requires explicit confirmation and may include an optional note to the host. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
list_my_alerts
ChatGPTList all of the signed-in golfer's alerts for tee-time openings and public hosted games. Returns each alert's course, date range, time window, player count, recurrence, status, fatigue state, and phone-verification state. Use get_my_alert for one alert. If phone verification is required, call request_phone_verification, tell the golfer to check their phone and provide the code, then call verify_phone_code; do not expose a full phone number in the response. When the alerts widget renders, acknowledge briefly without repeating alert rows; if unavailable, summarize the result in text. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
list_my_course_lists
ChatGPTList named course collections. MCP Apps use the advertised widget; other clients use the complete structured result. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
list_my_dashboard_tee_times
ChatGPTList the signed-in golfer's PRIMO games and invitations; upcoming games and invitations are default, past or all only when asked. Use the widget once; without repeating its rows. If unavailable, summarize. Read-only; games:read. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
list_my_groups
ChatGPTList or edit player groups; pass groupId to open its existing editor. MCP Apps use the advertised widget; other clients use the complete structured result. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
list_vendor_reservations
ChatGPTOn request, read your ForeUp reservations at one course through your captured account. Merchant-returned list may omit bookings; the shop is the authority. No background polling. Missing connection returns secure connect. Numbered rows include matching PRIMO games when found. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
lookup_booking_attempt
ChatGPTRead configured merchant recovery candidates for your attempt. Candidates are not exact confirmation; zero/partial results never authorize resubmission. No vendor or ledger write.
manage_game_participant
ChatGPTConfirm or remove a golfer. Brief outcome; show refreshed dashboard once without repeating rows. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
pause_alert
ChatGPTPause one golf alert or list watch. Reversible with resume_alert; send history stays intact. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
read_booking_attempt
ChatGPTRead your durable submission attempt. Pending/unknown never authorizes another submission. No merchant write.
read_booking_progress
ChatGPTRead your existing booking activity by booking_id. No state change or submission. Never infer success from preparation.
reconnect_booking
ChatGPTIssue secure course connect even while connected. Completion replaces the merchant binding; verify returned bound_identity. No booking submitted or credentials in chat. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
record_booking_outcome
ChatGPTRecord evidence on the durable attempt: confirmed only after visible merchant confirmation; saved only after PRIMO save. A timeout is unknown, never verified failure. Never card data.
refresh_booking
ChatGPTRefresh an existing hold and its review using the same hold_id. May renew the merchant hold; never authorizes confirmation. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
register_booking_attempt
ChatGPTBefore one final merchant click, register the approved review already stored in booking context. Requires confirming status. Only first can_submit_once:true permits a click; replay never permits another.
release_invalid_hold_attempt
ChatGPTExplicit ForeUp invalid-null-ID hold resolution. Requires an operator-signed audit, expired hold, course verification, fresh open-slot and game checks, and authenticated lookup 404. No booking or cancel. Never invent evidence or force-clear a lock. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
remove_course_from_list
ChatGPTRemove a course from one of your course lists. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
remove_game_participant
ChatGPTRemove one golfer from an owned game. Requires the exact tee-time and slot IDs; confirm the removal and refresh the dashboard once. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
rename_my_course_list
ChatGPTRename one of your course lists. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
request_phone_verification
ChatGPTSend one six-digit SMS verification code for the phone used by golf alerts. Call this before verify_phone_code; tell the golfer to check their phone and reply with the code. If the phone is already verified, do not resend unless asked. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
respond_alert_fatigue
ChatGPTRecord an explicit fatigue choice (keep, deactivate, or prompted) for the displayed band; never infer or deactivate without explicit choice. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
resume_alert
ChatGPTResume one paused golf alert or list watch and refresh the alerts widget. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
search_courses
ChatGPTFind courses by city or ZIP; resolve near-me first; do not fan out search_tee_times. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
search_golfers
ChatGPTSearch golfers. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
search_group_availability
ChatGPTFind group tee-time availability across selected or nearby courses for a date, time window, and player count. Returns foursome math and per-course availability. Read-only; never books. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
search_joinable_games
ChatGPTJoinable games. Full widget records are in _meta.primo.widgetData; use the summary and Join action; never repeat rows. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
search_tee_times
ChatGPTFind tee times for one resolved course; search_courses first for locations; no fan-out When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
search_tee_times_by_course_name
ChatGPTNamed tee times: one match opens availability; layouts at one facility open grouped availability; different facilities open a multi-select picker. Never guess or fan out. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
show_game_course_picker
ChatGPTDisplay unresolved game-course choices using create_my_game's selection_token. Call once only for course_selection_required. Does not search or create a game. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
start_booking
ChatGPTCreate preparing activity; returns a new booking_id. Reuse a returned ID with read_booking_progress. A stable booking_context.handoff_id deduplicates starts. No card data.
update_alert
ChatGPTEdit the criteria, name, category, schedule, or verified phone for one golf alert. Use pause_alert, resume_alert, exclude_alert_course, respond_alert_fatigue, or delete_alert for those separate operations. Preserve criteria_revision when changing list-watch criteria and use request_phone_verification then verify_phone_code for a new number. When rendered, the PRIMO widget exclusively owns UI: no GenUI, duplicate rows/cards/tables/maps/forms, or image lookups. Brief acknowledgment only; text fallback if unavailable. Honor user requests and required confirmations.
update_booking_progress
ChatGPTUpdate factual activity and known review context. Complete requires vendor_confirmed:true and saved game_id; linked attempts must already be saved. No card data.
update_game_slot
ChatGPTUpdate player setup. Ask Index or Course HCP for ambiguous handicaps. Brief outcome; refreshed dashboard once. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
update_my_game
ChatGPTUpdate game details or markedBooked/confirmationNumber. Brief outcome; refresh dashboard once. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
update_my_group
ChatGPTUpdate a player group. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
update_my_profile
ChatGPTUpdate the signed-in golfer's profile and sync Cloud Clubhouse. This overwrites the submitted personal fields; clarify ambiguous handicaps, report partial failures, and never auto-retry. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
upload_my_avatar
ChatGPTUpload your selected photo from My Profile; reuse PRIMO storage and sync the linked player. Widget-only. Never auto-retry. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.
verify_phone_code
ChatGPTConfirm the six-digit SMS code after the golfer replies, marking the phone verified for golf alerts. Call only after request_phone_verification sends the code; then retry create_alert with the challenge ID and consent. Use returned refreshed PRIMO UI once; no duplicate refresh, GenUI, or image lookup. Preserve errors and confirmations.