Tools
| Name | Description |
|---|---|
list_locationsList Square seller locations. | List Square seller locations. |
list_catalog_objectsList Square catalog objects such as items, variations, modifiers, taxes, and discounts. | List Square catalog objects such as items, variations, modifiers, taxes, and discounts. |
get_catalog_objectGet a Square catalog object by ID with related objects. | Get a Square catalog object by ID with related objects. |
create_paymentCreate a payment in Square | Create a payment in Square |
list_paymentsList payments with optional filtering | List payments with optional filtering |
create_customerCreate a new customer in Square | Create a new customer in Square |
list_customersList customers in Square | List customers in Square |
create_orderCreate a new order in Square | Create a new order in Square |
list_ordersSearch orders by location IDs | Search orders by location IDs |
update_orderUpdate a Square order by exact order ID. Requires confirmation. | Update a Square order by exact order ID. Requires confirmation. |
pay_orderMark a Square order paid with one or more payment IDs. Requires confirmation. | Mark a Square order paid with one or more payment IDs. Requires confirmation. |
refund_paymentRefund a Square payment. Requires confirmation. | Refund a Square payment. Requires confirmation. |
cancel_paymentCancel an authorized Square payment before completion. Requires confirmation. | Cancel an authorized Square payment before completion. Requires confirmation. |
create_invoiceCreate a new invoice in Square | Create a new invoice in Square |
custom_api_callMake a custom API call to the Square API | Make a custom API call to the Square API |
Triggers
| Name | Description |
|---|---|
payment_completedTriggers when a payment is completed | Triggers when a payment is completed |
order_createdTriggers when a new order is created | Triggers when a new order is created |
customer_createdTriggers when a new customer is created | Triggers when a new customer is created |
order_updatedTriggers when Square sends order.updated. | Triggers when Square sends order.updated. |
catalog_version_updatedTriggers when Square sends catalog.version.updated. | Triggers when Square sends catalog.version.updated. |
inventory_count_updatedTriggers when Square sends inventory.count.updated. | Triggers when Square sends inventory.count.updated. |
refund_updatedTriggers when Square sends refund.updated. | Triggers when Square sends refund.updated. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('square', 'list_locations', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'square',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect Square to my app?
Use Weavz Hosted Connect for API Key authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does Square support?
Square supports 15 tools including List Locations, List Catalog Objects, Get Catalog Object, Create Payment, List Payments, and more.
Can I use Square with AI agents?
Yes. Add Square to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
How do I connect Square to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add Square as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped Square tools exposed by that workspace.
Does Square work with Claude Code, Cursor, Codex, and local agents?
Yes. Remote and local MCP clients can connect to a Weavz MCP endpoint for the workspace. Local coding agents can also use the Weavz CLI to inspect apps, discover actions, run approved Square work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with Square?
Square exposes 15 tools, including List Locations, List Catalog Objects, Get Catalog Object, Create Payment, List Payments, and more. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can Square be used in stateful agent workflows?
Yes. Agents can combine Square tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does Square use?
Square uses API Key. Weavz stores credentials securely and uses them for authorized action execution.
How much does the Square integration cost?
The Square integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
What triggers does Square support?
Square supports 7 triggers including Payment Completed, Order Created, Customer Created, Order Updated, Catalog Version Updated, and more.
Connect Square in minutes
Get 20,000 free action executions every month. No credit card required.