KosmoKrator

sales

Square MCP Integration for Codex

Connect Square to Codex 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 Codex

Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.

Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with --write=deny so Codex can inspect read-capable tools without receiving write access by default.

Square MCP Config for Codex

Keep write access denied or ask-based unless the workspace is trusted.

{
  "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 Codex

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

MCP toolSource functionTypeDescription
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 CodexClient-level gateway setup.