Home / Servers / Square API / list_gift_cards
ListGiftCards
An MCP tool from the Square API server, hosted on mcp.hjlabs.in.
ListGiftCards Lists all gift cards. You can specify optional filters to retrieve a subset of the gift cards. Results are sorted by created_at in ascending order. [GET /v2/gift-cards]
Name on the gateway: square_api__list_gift_cards · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
type | string | If a type is provided, the endpoint returns gift cards of the specified type.… |
state | string | If a state is provided, the endpoint returns the gift cards in the specified… |
limit | integer | If a limit is provided, the endpoint returns only the specified number of… |
cursor | string | A pagination cursor returned by a previous call to this endpoint. Provide this… |
customer_id | string | If a customer ID is provided, the endpoint returns only the gift cards linked… |
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_cards",
"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 listgiftcards tool with type set to ….