Get a loyalty customer
A Yotpo Loyalty customer's status, tier, points balance, total earned and last activity, found by email.
MCP tool yotpo_read → get_loyalty_customer
read
Opens the profile the Customers page shows for one email address: Member or Not Enrolled, tier, current points balance, total points earned and deducted, join date, total spend, last loyalty activity and tags. The email must match exactly, with no spaces. A customer who is Not Enrolled has no balance to adjust.
Parameters
| Name | Type | Description |
|---|---|---|
| email string required | string | Customer email address, exactly as in Yotpo. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "yotpo_read",
"arguments": {
"operation": "get_loyalty_customer",
"arguments": {
"email": "jane@example.com"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"email": "ana.lopez@example.com",
"status": "Member",
"tier": "Silver",
"points_balance": 90,
"points_earned_total": 1020,
"points_deducted_total": 930,
"joined_at": "2025-03-14",
"total_spend": 612.4,
"last_loyalty_activity": "2026-10-19",
"tags": [
"newsletter"
]
},
"isError": false
}