Home / Servers / Square API / list_merchant_custom_attributes

ListMerchantCustomAttributes

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

ListMerchantCustomAttributes Lists the custom attributes associated with a merchant. You can use the with_definitions query parameter to also retrieve custom attribute definitions in the same call. When all response pages are… [GET /v2/merchants/{merchant_id}/custom-attributes]

Name on the gateway: square_api__list_merchant_custom_attributes · read-only.

Parameters

NameTypeDescription
merchant_id requiredstringThe ID of the target merchant.
visibility_filterALL | READ | READ_WRITEFilters the CustomAttributeDefinition results by their visibility values.
limitintegerThe maximum number of results to return in a single paged response. This limit…
cursorstringThe cursor returned in the paged response from the previous call to this…
with_definitionsbooleanIndicates whether to return the custom attribute definition in the definition…

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_merchant_custom_attributes",
  "arguments": {
    "merchant_id": "…"
  }
}

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 listmerchantcustomattributes tool with merchant_id set to ….

More from Square API