Home / Servers / Square API / search_catalog_objects

SearchCatalogObjects

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

SearchCatalogObjects Searches for CatalogObject of any type by matching supported search attribute values, excluding custom attribute values on items or item variations, against one or more of the specified query… [POST /v2/catalog/search]

Name on the gateway: square_api__search_catalog_objects · may change things.

Parameters

NameTypeDescription
cursorstringThe pagination cursor returned in the previous response. Leave unset for an…
object_typesarrayThe desired set of object types to appear in the search results. If this is…
include_deleted_objectsbooleanIf true, deleted objects will be included in the results. Defaults to false.…
include_related_objectsbooleanIf true, the response will include additional objects that are related to the…
begin_timestringReturn objects modified after this timestamp, in RFC 3339 format, e.g.…
queryobjectA query to be used to filter or sort the results. If no query is specified…
limitintegerA limit on the number of results to be returned in a single page. The limit is…
include_category_path_to_rootbooleanSpecifies whether or not to include the path_to_root list for each returned…
include_optionsobjectOptions 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:

call_tool arguments
{
  "name": "square_api__search_catalog_objects",
  "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 searchcatalogobjects tool with cursor set to ….

More from Square API