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 Integration for LangChain

Connect Square to LangChain through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 7 read 0 write Bearer token auth

Submit Square feedback View package source

Connect Square to LangChain

Bridge LangChain agents to local KosmoKrator integration tools through MCP or headless CLI calls.

Use the MCP gateway when the agent should discover tools, or wrap kosmo integrations:call for fixed chains. The gateway is local, scoped to this integration, and starts with --write=deny so LangChain can inspect read-capable tools without receiving write access by default.

Square MCP Config for LangChain

Keep the gateway scoped to the integration and operation class needed by the chain.

{
  "mcpServers": {
    "kosmokrator-square": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=square",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=square --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Square instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Square Tools Visible to LangChain

LangChain sees stable MCP tool names generated from the Square integration catalog.

MCP tool	Source function	Type	Description
`integration__square__square_get_current_user`	`square.square_get_current_user`	Read	Get the current authenticated Square merchant account. Returns merchant details including business name, country, currency, and status.
`integration__square__square_get_customer`	`square.square_get_customer`	Read	Retrieve a Square customer by ID. Returns full customer details including email, phone, address, and cards on file.
`integration__square__square_get_order`	`square.square_get_order`	Read	Retrieve a Square order by ID. Returns full order details including line items, totals, taxes, and discounts.
`integration__square__square_get_payment`	`square.square_get_payment`	Read	Retrieve a Square payment by ID. Returns full payment details including amount, status, card details, and processing fees.
`integration__square__square_list_customers`	`square.square_list_customers`	Read	List Square customers with optional filtering. Supports pagination with cursor.
`integration__square__square_list_orders`	`square.square_list_orders`	Read	List Square orders for a specific location. Requires a location_id. Supports filtering by order states and pagination with cursor.
`integration__square__square_list_payments`	`square.square_list_payments`	Read	List Square payments with optional filtering. Supports filtering by location ID, begin_time / end_time (ISO 8601), and pagination with cursor.

Related Square Pages

Square CLIUse direct JSON commands instead of MCP discovery. Square MCPFull gateway reference and MCP tool names. KosmoKrator for LangChainClient-level gateway setup.