KosmoKrator

data

Square MCP, CLI, and Lua Integration for AI Agents

Square integration docs for AI agents: MCP gateway setup, Square CLI commands, Lua API reference, credentials, and function schemas.

Square for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Square CLIHeadless setup, JSON output, direct function calls. Square MCPExpose selected tools to local MCP clients. Square LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug
square
route_slug
square
package
square
auth_strategy
bearer_token
cli_setup_supported
true
cli_runtime_supported
true
mcp_gateway_supported
true
lua_supported
true

Function Catalog

FunctionTypeParametersDescription
square.square_get_current_user Read read 0 Get the current authenticated Square merchant account. Returns merchant details including business name, country, currency, and status.
square.square_get_customer Read read 1 Retrieve a Square customer by ID. Returns full customer details including email, phone, address, and cards on file.
square.square_get_order Read read 1 Retrieve a Square order by ID. Returns full order details including line items, totals, taxes, and discounts.
square.square_get_payment Read read 1 Retrieve a Square payment by ID. Returns full payment details including amount, status, card details, and processing fees.
square.square_create_payment Write write 8 Create a new payment in Square. Requires a payment source ID (e.g., a card nonce or card-on-file ID), an idempotency key, and the amount with currency.
square.square_list_customers Read read 4 List Square customers with optional filtering. Supports pagination with cursor.
square.square_create_customer Write write 4 Create a new customer profile in Square with name, email, and phone details.
square.square_list_orders Read read 4 List Square orders for a specific location. Requires a location_id. Supports filtering by order states and pagination with cursor.
square.square_list_payments Read read 5 List Square payments with optional filtering. Supports filtering by location ID, begin_time / end_time (ISO 8601), and pagination with cursor.
square.square_list_locations Read read 0 List all business locations configured in Square, including name, address, and status.