Home / Servers / Square API / list_loyalty_promotions
ListLoyaltyPromotions
An MCP tool from the Square API server, hosted on mcp.hjlabs.in.
ListLoyaltyPromotions Lists the loyalty promotions associated with a loyalty program. Results are sorted by the created_at date in descending order (newest to oldest). [GET /v2/loyalty/programs/{program_id}/promotions]
Name on the gateway: square_api__list_loyalty_promotions · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
program_id required | string | The ID of the base loyalty program. To get the program ID… |
status | ACTIVE | ENDED | CANCELED | SCHEDULED | The status to filter the results by. If a status is provided, only loyalty… |
cursor | string | The cursor returned in the paged response from the previous call to this… |
limit | integer | The maximum number of results to return in a single paged response. The… |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "square_api__list_loyalty_promotions",
"arguments": {
"program_id": "…"
}
}Or connect the Square API server directly, which lists 308 tools including this one:
claude mcp add --transport http hj-square-api https://mcp.hjlabs.in/mcp/square-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the listloyaltypromotions tool with program_id set to ….