Home / Servers / Square API / search_orders
SearchOrders
An MCP tool from the Square API server, hosted on mcp.hjlabs.in.
SearchOrders Search all orders for one or more locations. Orders include all sales, returns, and exchanges regardless of how or when they entered the Square ecosystem (such as Point of Sale, Invoices, and… [POST /v2/orders/search]
Name on the gateway: square_api__search_orders · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
location_ids | array | The location IDs for the orders to query. All locations must belong to the… |
cursor | string | A pagination cursor returned by a previous call to this endpoint. Provide this… |
query | object | Query conditions used to filter or sort the results. Note that when retrieving… |
limit | integer | The maximum number of results to be returned in a single page. Default: 500… |
return_entries | boolean | A Boolean that controls the format of the search results. If true… |
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_orders",
"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 searchorders tool with location_ids set to ….