Square

List merchants associated with the access token. Args: - format: Response format Returns: List of merchants.

Get a cash drawer shift by ID. Args: - location_id: Location ID - shift_id: Shift ID - format: Response format Returns: The cash drawer shift.

Get merchant information. Args: - merchant_id: Merchant ID (use 'me' for current merchant) - format: Response format Returns: The merchant record.

Get a single booking by ID. Args: - booking_id: Booking ID - format: Response format Returns: The booking record.

List bank accounts linked to the Square account. Args: - cursor: Pagination cursor - limit: Maximum results - location_id: Filter by location ID - format: Response format Returns: List of bank accounts.

Get a bank account by ID. Args: - bank_account_id: Bank account ID - format: Response format Returns: The bank account record.

Get a bank account by its V1 ID. Args: - v1_bank_account_id: V1 bank account ID - format: Response format Returns: The bank account record.

List payouts for the Square account. Args: - location_id: Filter by location ID - status: Filter by payout status - begin_time: Filter by start time - end_time: Filter by end time - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: List of payouts.

Get a payout by ID. Args: - payout_id: Payout ID - format: Response format Returns: The payout record.

List disputes for the Square account. Args: - cursor: Pagination cursor - limit: Maximum results - states: Filter by dispute states - location_id: Filter by location ID - format: Response format Returns: List of disputes.

Get a dispute by ID. Args: - dispute_id: Dispute ID - format: Response format Returns: The dispute record.

Accept a dispute (concede to the cardholder). Args: - dispute_id: Dispute ID to accept Returns: The accepted dispute.

List vendors. Args: - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: List of vendors.

Get a vendor by ID. Args: - vendor_id: Vendor ID - format: Response format Returns: The vendor record.

Create a new vendor. Args: - name: Vendor name - address: Vendor address - contacts: Vendor contacts - account_number: Account number - note: Note about vendor - status: Vendor status Returns: The created vendor.

Update an existing vendor. Args: - vendor_id: Vendor ID to update - vendor: Updated vendor fields Returns: The updated vendor.

List cash drawer shifts. Args: - location_id: Location ID - begin_time: Filter by start time - end_time: Filter by end time - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: List of cash drawer shifts.

List bookings with optional filters. Args: - location_id: Filter by location - team_member_id: Filter by team member - start_at_min: Minimum start time (RFC 3339) - start_at_max: Maximum start time (RFC 3339) - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: Paginated list of bookings.

Create a new booking. Args: - start_at: Booking start time (RFC 3339) - location_id: Location ID - customer_id: Customer ID - customer_note: Note from customer - seller_note: Note from seller - appointment_segments: Appointment details Returns: The created booking.

Update an existing booking. Args: - booking_id: Booking ID to update - version: Booking version - start_at: New start time - customer_note: New customer note - seller_note: New seller note Returns: The updated booking.

Cancel a booking. Args: - booking_id: Booking ID to cancel - version: Booking version (optional) Returns: The cancelled booking.

List catalog objects with pagination. Args: - cursor: Pagination cursor - types: Filter by object types (ITEM, CATEGORY, TAX, DISCOUNT, etc.) - limit: Maximum results - format: Response format Returns: Paginated list of catalog objects.

Get a catalog object by ID. Args: - object_id: Catalog object ID - include_related_objects: Include related objects - format: Response format Returns: The catalog object.

Search for catalog objects. Args: - text_query: Text to search for - object_types: Filter by object types - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: Paginated list of catalog objects.

Create or update a catalog object. Args: - object: Catalog object to upsert - type: Object type (ITEM, CATEGORY, TAX, etc.) - id: Object ID (use #temp_id for new objects) - item_data: Item data (for ITEM type) - category_data: Category data (for CATEGORY type) - tax_data: Tax data (for TAX type) - discount_data: Discount data (for DISCOUNT type) Returns: The upserted catalog object.

Delete a catalog object. Args: - object_id: Catalog object ID to delete Returns: Confirmation of deletion.

Delete multiple catalog objects. Args: - object_ids: Array of catalog object IDs to delete Returns: Confirmation of deletion.

Create or update multiple catalog objects. Args: - objects: Array of catalog objects to upsert Returns: The upserted catalog objects.

List gift card activities. Args: - gift_card_id: Filter by gift card ID - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: Paginated list of gift card activities.

Get a single refund by ID. Args: - refund_id: The refund ID - format: Response format Returns: The refund record.

List customers from Square with pagination. Returns a paginated list of customers. Use the cursor from the response to fetch the next page. Args: - limit: Number of customers to return (1-100, default: 20) - cursor: Pagination cursor from previous response - sort_field: Field to sort by (CREATED_AT or DEFAULT) - sort_order: Sort order (ASC or DESC) - format: Response format ('json' or 'markdown') Returns: JSON format: { items: Customer[], count, hasMore, nextCursor }

Get a single customer by ID. Args: - customer_id: The customer ID - format: Response format ('json' or 'markdown') Returns: The customer record with all available fields.

Create a new customer in Square. Args: - given_name: First name - family_name: Last name - email_address: Email address - phone_number: Phone number (E.164 format recommended) - company_name: Company name - nickname: Nickname - address: Address object - birthday: Birthday (YYYY-MM-DD) - reference_id: Reference ID from external system - note: Note about the customer Returns: The created customer record.

Update an existing customer. Args: - customer_id: Customer ID to update - given_name: New first name - family_name: New last name - email_address: New email - phone_number: New phone - company_name: New company name - nickname: New nickname - address: New address - birthday: New birthday - note: New note Returns: The updated customer record.

Delete a customer from Square. Args: - customer_id: Customer ID to delete Returns: Confirmation of deletion.

Search for customers matching criteria. Args: - query: Search query object with filters - limit: Maximum results to return - cursor: Pagination cursor - format: Response format Returns: Paginated list of matching customers.

List all customer groups. Args: - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: List of customer groups.

Create a new customer group. Args: - name: Group name Returns: The created customer group.

List gift cards. Args: - type: Filter by type (DIGITAL, PHYSICAL) - state: Filter by state (ACTIVE, DEACTIVATED, etc.) - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: Paginated list of gift cards.

Get a gift card by ID. Args: - gift_card_id: Gift card ID - format: Response format Returns: The gift card.

Get a gift card by GAN (Gift card Account Number). Args: - gan: Gift card account number - format: Response format Returns: The gift card.

Create a new gift card. Args: - type: Gift card type (DIGITAL or PHYSICAL) - location_id: Location ID Returns: The created gift card.

Link a customer to a gift card. Args: - gift_card_id: Gift card ID - customer_id: Customer ID Returns: The updated gift card.

Unlink a customer from a gift card. Args: - gift_card_id: Gift card ID - customer_id: Customer ID Returns: The updated gift card.

Create a gift card activity (activate, load, redeem, etc.). Args: - gift_card_id: Gift card ID - location_id: Location ID - activity_type: Activity type (ACTIVATE, LOAD, REDEEM, etc.) - amount_money: Amount for LOAD activities { amount, currency } Returns: The created gift card activity.

Get inventory count for a catalog object. Args: - catalog_object_id: Catalog object ID (item variation) - location_ids: Filter by location IDs - format: Response format Returns: Inventory counts.

Get inventory counts for multiple catalog objects. Args: - catalog_object_ids: Array of catalog object IDs - location_ids: Filter by location IDs - format: Response format Returns: Inventory counts.

Batch change inventory counts. Args: - changes: Array of inventory changes - type: Change type (PHYSICAL_COUNT, ADJUSTMENT, TRANSFER) - physical_count: Physical count data - adjustment: Adjustment data - transfer: Transfer data Returns: Updated inventory counts.

List invoices for a location. Args: - location_id: Location ID - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: Paginated list of invoices.

Get a single invoice by ID. Args: - invoice_id: Invoice ID - format: Response format Returns: The invoice record.

Create a new invoice. Args: - location_id: Location ID - order_id: Order ID to invoice - customer_id: Customer ID for primary recipient - title: Invoice title - description: Invoice description - invoice_number: Custom invoice number - delivery_method: How to deliver (EMAIL, SHARE_MANUALLY, SMS) - payment_requests: Payment request details Returns: The created invoice.

Update an existing invoice. Args: - invoice_id: Invoice ID to update - version: Invoice version (required for concurrency) - title: New title - description: New description - delivery_method: New delivery method Returns: The updated invoice.

Delete an invoice. Args: - invoice_id: Invoice ID to delete Returns: Confirmation of deletion.

Publish a draft invoice. Args: - invoice_id: Invoice ID to publish - version: Invoice version (required for concurrency) Returns: The published invoice.

Cancel an invoice. Args: - invoice_id: Invoice ID to cancel - version: Invoice version (required for concurrency) Returns: The cancelled invoice.

List all locations for the Square account. Returns all business locations associated with the account. Args: - format: Response format ('json' or 'markdown') Returns: List of locations with details like name, address, timezone, and status.

Get a single location by ID. Args: - location_id: The location ID - format: Response format ('json' or 'markdown') Returns: The location record with all available fields.

Update an existing order. Args: - order_id: Order ID to update - state: New order state - version: Order version Returns: The updated order.

Create a new location. Args: - name: Business name for the location - address: Address object with address_line_1, locality, administrative_district_level_1, postal_code, country - timezone: IANA timezone (e.g., 'America/Los_Angeles') - description: Description of the location - phone_number: Phone number - business_email: Business email address - website_url: Website URL - business_hours: Business hours configuration Returns: The created location record.

Update an existing location. Args: - location_id: Location ID to update - name: New business name - address: New address - timezone: New timezone - description: New description - phone_number: New phone number - business_email: New email - website_url: New website URL - status: Location status (ACTIVE or INACTIVE) Returns: The updated location record.

Get a loyalty program by ID. Args: - program_id: Loyalty program ID - format: Response format Returns: The loyalty program.

List all loyalty programs. Args: - format: Response format Returns: List of loyalty programs.

Create a loyalty account. Args: - program_id: Loyalty program ID - phone_number: Customer phone number Returns: The created loyalty account.

Get a loyalty account by ID. Args: - account_id: Loyalty account ID - format: Response format Returns: The loyalty account.

Search for loyalty accounts. Args: - phone_number: Search by phone number - customer_id: Search by customer ID - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: Paginated list of loyalty accounts.

Accumulate points on a loyalty account. Args: - account_id: Loyalty account ID - points: Points to accumulate - order_id: Associated order ID Returns: The updated loyalty account.

Adjust points on a loyalty account (positive or negative). Args: - account_id: Loyalty account ID - points: Points adjustment (positive to add, negative to subtract) - reason: Reason for adjustment Returns: The updated loyalty account.

Create a loyalty reward. Args: - loyalty_account_id: Loyalty account ID - reward_tier_id: Reward tier ID Returns: The created loyalty reward.

Redeem a loyalty reward. Args: - reward_id: Reward ID to redeem - location_id: Location ID Returns: The redeemed loyalty reward.

Delete a loyalty reward. Args: - reward_id: Reward ID to delete Returns: Confirmation of deletion.

Create a new order. Args: - location_id: Location ID for the order - line_items: Array of line items - customer_id: Customer ID - reference_id: External reference ID Returns: The created order record.

Get a single order by ID. Args: - order_id: The order ID - format: Response format Returns: The order record.

Search for orders. Args: - location_ids: Filter by location IDs - states: Filter by order states - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: Paginated list of orders.

Pay for an order using one or more payment IDs. Args: - order_id: Order ID to pay - payment_ids: Array of payment IDs Returns: The paid order.

List payments from Square with pagination. Returns a paginated list of payments. Use the cursor from the response to fetch the next page. Args: - begin_time: Start of time range (RFC 3339) - end_time: End of time range (RFC 3339) - location_id: Filter by location - cursor: Pagination cursor - limit: Number of payments to return (1-100, default: 20) - format: Response format ('json' or 'markdown') Returns: JSON format: { items: Payment[], count, hasMore, nextCursor }

Get a single payment by ID. Args: - payment_id: The payment ID - format: Response format ('json' or 'markdown') Returns: The payment record with all available fields.

Create a new payment. Args: - source_id: Payment source ID (card nonce, card ID, or 'CASH') - amount_money: Amount to charge { amount: number (in cents), currency: string } - location_id: Location ID (uses default if not provided) - customer_id: Customer ID to associate with payment - reference_id: Reference ID from external system - note: Note for the payment - autocomplete: Whether to auto-complete (default: true) - buyer_email_address: Buyer's email for receipt Returns: The created payment record.

Complete a payment that was created with autocomplete=false. Args: - payment_id: Payment ID to complete Returns: The completed payment record.

Cancel a payment that has not been completed. Args: - payment_id: Payment ID to cancel Returns: The cancelled payment record.

List refunds from Square with pagination. Args: - begin_time: Start of time range (RFC 3339) - end_time: End of time range (RFC 3339) - location_id: Filter by location - cursor: Pagination cursor - limit: Number of refunds to return - format: Response format Returns: Paginated list of refunds.

Refund a payment. Args: - payment_id: Payment ID to refund - amount_money: Amount to refund { amount: number (in cents), currency: string } - reason: Reason for refund Returns: The created refund record.

List subscriptions. Args: - customer_id: Filter by customer - location_id: Filter by location - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: Paginated list of subscriptions.

Get a single subscription by ID. Args: - subscription_id: Subscription ID - format: Response format Returns: The subscription record.

Create a new subscription. Args: - location_id: Location ID - customer_id: Customer ID - plan_variation_id: Plan variation ID - start_date: Start date (YYYY-MM-DD) - card_id: Card ID for payment - timezone: Timezone Returns: The created subscription.

Update an existing subscription. Args: - subscription_id: Subscription ID - card_id: New card ID - version: Subscription version Returns: The updated subscription.

Cancel a subscription. Args: - subscription_id: Subscription ID to cancel Returns: The cancelled subscription.

Pause a subscription. Args: - subscription_id: Subscription ID to pause Returns: The paused subscription.

Resume a paused subscription. Args: - subscription_id: Subscription ID to resume Returns: The resumed subscription.

List team members. Args: - status: Filter by status (ACTIVE or INACTIVE) - location_ids: Filter by location IDs - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: Paginated list of team members.

Get a team member by ID. Args: - team_member_id: Team member ID - format: Response format Returns: The team member.

Create a new team member. Args: - given_name: First name - family_name: Last name - email_address: Email address - phone_number: Phone number - status: Status (ACTIVE or INACTIVE) - location_ids: Assigned location IDs Returns: The created team member.

Update a team member. Args: - team_member_id: Team member ID - given_name: New first name - family_name: New last name - email_address: New email - phone_number: New phone number - status: New status Returns: The updated team member.

Create a Terminal action. Args: - device_id: Device ID to target - deadline_duration: Deadline for the action - save_card_options: Save card details - receipt_options: Receipt details - confirmation_options: Confirmation options - select_options: Select options - signature_options: Signature options - data_collection_options: Data collection options - qr_code_options: QR code options Returns: The created Terminal action.

Get a Terminal action by ID. Args: - action_id: Terminal action ID - format: Response format Returns: The Terminal action.

Search for Terminal actions. Args: - query: Search query with filters - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: List of Terminal actions.

Cancel a Terminal action. Args: - action_id: Terminal action ID to cancel Returns: The cancelled Terminal action.

Create a Terminal checkout to take a payment. Args: - amount_money: Amount to charge - device_options: Device configuration - device_id: Device ID - skip_receipt_screen: Skip receipt screen - collect_signature: Collect signature - tip_settings: Tip settings - show_itemized_cart: Show itemized cart - reference_id: Reference ID - note: Note for the checkout - order_id: Order ID to link - payment_options: Payment options - customer_id: Customer ID - app_fee_money: App fee amount - deadline_duration: Deadline in ISO 8601 format - payment_type: Payment type Returns: The created Terminal checkout.

Get a Terminal checkout by ID. Args: - checkout_id: Terminal checkout ID - format: Response format Returns: The Terminal checkout.

Search for Terminal checkouts. Args: - query: Search query with filters - cursor: Pagination cursor - limit: Maximum results - format: Response format Returns: List of Terminal checkouts.

Cancel a Terminal checkout. Args: - checkout_id: Terminal checkout ID to cancel Returns: The cancelled Terminal checkout.

Create a Terminal refund. Args: - payment_id: Payment ID to refund - amount_money: Amount to refund - reason: Reason for refund - device_id: Device ID for the refund - deadline_duration: Deadline in ISO 8601 format Returns: The created Terminal refund.

Get a Terminal refund by ID. Args: - terminal_refund_id: Terminal refund ID - format: Response format Returns: The Terminal refund.

Cancel a Terminal refund. Args: - terminal_refund_id: Terminal refund ID to cancel Returns: The cancelled Terminal refund.