Status: Implemented | Module: member
Retrieve the phone numbers on file for the verified member. Read companion to update_member_phone — use this to read back existing contact numbers to the member, or to obtain a phone_id for the intent=replace flow on update_member_phone.
| Hint |
Value |
| readOnlyHint |
true |
| destructiveHint |
false |
| idempotentHint |
true |
| Field |
Type |
Required |
Description |
session_id |
string |
yes |
Active session ID from verify_member |
| Field |
Type |
Description |
status |
string |
success or error |
phones |
MemberPhone[] |
Phone records on file (may be empty) |
count |
int |
Number of phones returned |
message |
string |
Human summary (e.g. “Found 2 phone(s) for member.”) |
guidance |
Guidance |
Next-step suggestion (add phone if none, or proceed with booking) |
| Field |
Type |
Description |
phone_id |
string |
Phone record UUID (pass to update_member_phone as replace_phone_id) |
number |
string |
Phone number (E.164: +1XXXXXXXXXX) |
phone_type |
string |
mobile, home, or work |
is_primary |
bool |
Whether this is the primary phone |
note |
string |
Optional label (e.g. “Caretaker phone”) |
- Reads session via
SessionManager and refreshes its TTL.
- Emits a HIPAA audit entry
mcp.get_member_phone with phone_count metadata only — the actual number is never written to audit.
- Requires
session.LobID and session.MemberID populated by verify_member (returns an error otherwise).
- Source:
internal/app/member/usecases/get_member_phone.go, internal/app/member/register.go
- Companion: update_member_phone (use
phone_id from this response as replace_phone_id under intent=replace)
- Prerequisite: verify_member