Home / Servers / Square API / list_gift_card_activities
ListGiftCardActivities
An MCP tool from the Square API server, hosted on mcp.hjlabs.in.
ListGiftCardActivities Lists gift card activities. By default, you get gift card activities for all gift cards in the seller's account. You can optionally specify query parameters to filter the list. For example, you can… [GET /v2/gift-cards/activities]
Name on the gateway: square_api__list_gift_card_activities · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
gift_card_id | string | If a gift card ID is provided, the endpoint returns activities related to the… |
type | string | If a type is provided, the endpoint returns gift card activities of the… |
location_id | string | If a location ID is provided, the endpoint returns gift card activities for… |
begin_time | string | The timestamp for the beginning of the reporting period, in RFC 3339 format.… |
end_time | string | The timestamp for the end of the reporting period, in RFC 3339 format. This… |
limit | integer | If a limit is provided, the endpoint returns the specified number of results… |
cursor | string | A pagination cursor returned by a previous call to this endpoint. Provide this… |
sort_order | string | The order in which the endpoint returns the activities, based on created_at.… |
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_gift_card_activities",
"arguments": {}
}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 listgiftcardactivities tool with gift_card_id set to ….