Home / Servers / Square API / batch_retrieve_inventory_counts

BatchRetrieveInventoryCounts

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

BatchRetrieveInventoryCounts Returns current counts for the provided CatalogObjects at the requested Locations. Results are paginated and sorted in descending order according to their calculated_at timestamp (newest first).… [POST /v2/inventory/counts/batch-retrieve]

Name on the gateway: square_api__batch_retrieve_inventory_counts · may change things.

Parameters

NameTypeDescription
catalog_object_idsarrayThe filter to return results by CatalogObject ID. The filter is applicable…
location_idsarrayThe filter to return results by Location ID. This filter is applicable only…
updated_afterstringThe filter to return results with their calculated_at value after the given…
cursorstringA pagination cursor returned by a previous call to this endpoint. Provide this…
statesarrayThe filter to return results by InventoryState. The filter is only applicable…
limitintegerThe number of records to return.

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__batch_retrieve_inventory_counts",
  "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 batchretrieveinventorycounts tool with catalog_object_ids set to ….

More from Square API