business
Manage Square business operations including merchants, locations, vendors, and sites through a unified interface for operational control.
Instructions
Manage business operations
Args:
operation: The operation to perform. Valid operations:
Merchants:
- list_merchants
- retrieve_merchant
Locations:
- list_locations
- create_location
- retrieve_location
- update_location
Vendors:
- bulk_create_vendors
- bulk_retrieve_vendors
- create_vendor
- search_vendors
- update_vendor
Sites:
- list_sites
params: Dictionary of parameters for the specific operation
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | Yes | ||
| params | Yes |
Implementation Reference
- src/square_mcp/server.py:686-748 (handler)The 'business' tool handler function, decorated with @mcp.tool(). It handles various Square API operations for merchants, locations, vendors, and sites based on the 'operation' parameter.@mcp.tool() async def business( operation: str, params: Dict[str, Any] ) -> Dict[str, Any]: """Manage business operations Args: operation: The operation to perform. Valid operations: Merchants: - list_merchants - retrieve_merchant Locations: - list_locations - create_location - retrieve_location - update_location Vendors: - bulk_create_vendors - bulk_retrieve_vendors - create_vendor - search_vendors - update_vendor Sites: - list_sites params: Dictionary of parameters for the specific operation """ try: match operation: # Merchants case "list_merchants": result = square_client.merchants.list_merchants(**params) case "retrieve_merchant": result = square_client.merchants.retrieve_merchant(**params) # Locations case "list_locations": result = square_client.locations.list_locations() case "create_location": result = square_client.locations.create_location(params) case "retrieve_location": result = square_client.locations.retrieve_location(**params) case "update_location": result = square_client.locations.update_location(**params) # Vendors case "bulk_create_vendors": result = square_client.vendors.bulk_create_vendors(params) case "bulk_retrieve_vendors": result = square_client.vendors.bulk_retrieve_vendors(params) case "create_vendor": result = square_client.vendors.create_vendor(params) case "search_vendors": result = square_client.vendors.search_vendors(params) case "update_vendor": result = square_client.vendors.update_vendor(**params) # Sites case "list_sites": result = square_client.sites.list_sites(**params) case _: raise McpError(INVALID_PARAMS, ErrorData(message=f"Invalid operation: {operation}")) return result.body except Exception as e: raise McpError(INTERNAL_ERROR, ErrorData(message=str(e)))
- src/square_mcp/server.py:687-712 (schema)Input schema defined by function parameters (operation: str, params: Dict[str, Any]) and comprehensive docstring listing valid operations and parameters.async def business( operation: str, params: Dict[str, Any] ) -> Dict[str, Any]: """Manage business operations Args: operation: The operation to perform. Valid operations: Merchants: - list_merchants - retrieve_merchant Locations: - list_locations - create_location - retrieve_location - update_location Vendors: - bulk_create_vendors - bulk_retrieve_vendors - create_vendor - search_vendors - update_vendor Sites: - list_sites params: Dictionary of parameters for the specific operation """
- src/square_mcp/server.py:686-686 (registration)The @mcp.tool() decorator registers the 'business' function as an MCP tool.@mcp.tool()