Home / Servers / Square API / list_customers

ListCustomers

An MCP tool from the Square API server, hosted on mcp.hjlabs.in.

ListCustomers Lists customer profiles associated with a Square account. Under normal operating conditions, newly created or updated customer profiles become available for the listing operation in well under 30… [GET /v2/customers]

Name on the gateway: square_api__list_customers · read-only.

Parameters

NameTypeDescription
cursorstringA pagination cursor returned by a previous call to this endpoint. Provide this…
limitintegerThe maximum number of results to return in a single page. This limit is…
sort_fieldDEFAULT | CREATED_ATIndicates how customers should be sorted. The default value is DEFAULT.
sort_orderDESC | ASCIndicates whether customers should be sorted in ascending (ASC) or descending…
countbooleanIndicates whether to return the total count of customers in the count field of…

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:

call_tool arguments
{
  "name": "square_api__list_customers",
  "arguments": {}
}

Or connect the Square API server directly, which lists 308 tools including this one:

Run in your terminal
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 listcustomers tool with cursor set to ….

More from Square API