Home / Servers / Square API / search_customers

SearchCustomers

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

SearchCustomers Searches the customer profiles associated with a Square account using one or more supported query filters. Calling SearchCustomers without any explicit query filter returns all customer profiles… [POST /v2/customers/search]

Name on the gateway: square_api__search_customers · may change things.

Parameters

NameTypeDescription
cursorstringInclude the pagination cursor in subsequent calls to this endpoint to retrieve…
limitintegerThe maximum number of results to return in a single page. This limit is…
queryobjectThe filtering and sorting criteria for the search request. If a query is not…
countbooleanIndicates whether to return the total count of matching customers in the count…

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__search_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 searchcustomers tool with cursor set to ….

More from Square API