Can I use Square as a CLI?

Yes. KosmoKrator exposes a Square CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Square through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Square tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Square credentials stored?

Square credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Square MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

sales

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.

7 functions 7 read 0 write Bearer token auth

Submit Square feedback View package source

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.

Machine-Readable Metadata

integration_slug: square
route_slug: square
package: square
auth_strategy: bearer_token Bearer token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Square CLIHeadless setup and direct function calls. Square MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Square MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Square.

Claude Code Square MCP setup for Claude Code. Cursor Square MCP setup for Cursor. Codex Square MCP setup for Codex. OpenAI Agents Square MCP setup for OpenAI Agents SDK. Claude Agent SDK Square MCP setup for Claude Agent SDK. Vercel AI SDK Square MCP setup for Vercel AI SDK. LangChain Square MCP setup for LangChain. LangGraph Square MCP setup for LangGraph. CrewAI Square MCP setup for CrewAI. MCP clients Square MCP setup for Generic MCP Clients.

Square CLI Matrix

Use these pages for direct Square CLI workflows in scripts, CI, cron, and agent wrappers.

CI Square CLI for CI. Cron Jobs Square CLI for cron jobs. Shell Scripts Square CLI for shell scripts. Headless Automation Square CLI for headless automation. Coding Agents Square CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`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_list_customers`	Read `read`	4	List Square customers with optional filtering. Supports pagination with cursor.
`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.