Home / Servers / Square API / search_catalog_items
SearchCatalogItems
An MCP tool from the Square API server, hosted on mcp.hjlabs.in.
SearchCatalogItems Searches for catalog items or item variations by matching supported search attribute values, including custom attribute values, against one or more of the specified query filters. This… [POST /v2/catalog/search-catalog-items]
Name on the gateway: square_api__search_catalog_items · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
text_filter | string | The text filter expression to return items or item variations containing… |
category_ids | array | The category id query expression to return items containing the specified… |
stock_levels | array | The stock-level query expression to return item variations with the specified… |
enabled_location_ids | array | The enabled-location query expression to return items and item variations… |
cursor | string | The pagination token, returned in the previous response, used to fetch the… |
limit | integer | The maximum number of results to return per page. The default value is 100. |
sort_order | DESC | ASC | The order to sort the results by item names. The default sort order is… |
product_types | array | The product types query expression to return items or item variations having… |
custom_attribute_filters | array | The customer-attribute filter to return items or item variations matching the… |
archived_state | ARCHIVED_STATE_NOT_ARCHIVED | ARCHIVED_STATE_ARCHIVED | ARCHIVED_STATE_ALL | The query filter to return not archived (ARCHIVED_STATE_NOT_ARCHIVED)… |
include_options | object | Options to include related resources in the response. |
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__search_catalog_items",
"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 searchcatalogitems tool with text_filter set to ….