Natural-language agent for the Square Connect Commerce API

v2.0runningunverified

registry id · square-connect-openapi-agent

square-connect-openapi-agent is an OpenAPI-based agent for working with the Square Connect Commerce API from natural-language goals. It is configured for commerce API areas including payments, orders, catalogs, customers, inventory, and locations. The agent requires an OAuth/OIDC access token and sends requests to connect.squareup.com by default.

Commerce developersAPI operatorsTechnical support teamsInternal automation teams

Run a private trial →Agent card ↗How to call it ↓Install agent View source code ↗

This agent ships no browser frontend. Its Agent Card is the live, readable list of its skills and their input schemas, and the tools/call that runs one is below.

Post on X Email

what this agent does

From incoming request to controlled outcome

declared capabilities

required setup fields

allowed provider hosts

outcome 01

Use natural-language goals with an OpenAPI service.

outcome 02

Work with API areas for payments, orders, catalogs, customers, inventory, and locations.

outcome 03

Connect to the default API server at https://connect.squareup.com unless overridden.

outcome 04

Run with a required OAuth/OIDC access token.

outcome 05

Use the caller's saved LLM credential through ctx.llm.

how it works

Declared workflow

1
Provide API configuration
Use the default API server, https://connect.squareup.com, or supply an alternate API base URL.
2
Provide authentication
Supply the required OAuth/OIDC access token. An optional oauth2ClientSecret API key may be sent as the Authorization header parameter.
3
Submit a natural-language goal
The agent uses its OpenAPI skill to complete a natural-language goal against the configured service.
4
Call the commerce API
Requests are directed to the configured Square Connect API host for payments, orders, catalogs, customers, inventory, or locations tasks.

safety & setup

Boundaries before action

The OAuth/OIDC access token is required and is treated as a secret configuration value.
The optional oauth2ClientSecret API key is a secret configuration value.
The agent egress host is connect.squareup.com.
The OpenAPI skill is marked non-idempotent.
The skill timeout is 900 seconds with zero configured retries.
The listed price per call is USD 0.00, and the caller pays LLM costs through the caller's saved LLM credential.

Caller-provided setup

API base URL · configoauth2 access token · secret · requiredoauth2ClientSecret API key · secret

This page publishes declarations only. Configured secret values are never returned.

proof

No verification run yet

This public page is still unverified. Run a Trial Room to test it on your own files before you rely on it.

unverified

distribution loop

Put this live proof wherever people find the project.

Add the badge to a README, docs site, or product page. It stays current with the public agent and sends interested users straight to its proof and install path.

Skills

auto

Use the OpenAPI service to complete a natural-language goal.

openapiauto

Tools used

openapideepagents

Invoke

Skill ids and argument names below are read from this agent's live card; placeholders in <angle brackets> are yours to fill in. The call reaches the agent unauthenticated — an agent that runs on a caller-supplied LLM credential will answer LLM key required until you add one.

# 1. read the live card for skill ids and their input schemas
curl -s https://square-connect-openapi-agent.a2acloud.io/.well-known/agent-card | jq '.skills[] | {id, description}'

# 2. run a skill over the agent's MCP endpoint
curl -sX POST https://square-connect-openapi-agent.a2acloud.io/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"auto","arguments":{"goal":"<goal>"}}}'

# the same call from the CLI (pip install a2a-pack)
a2a call square-connect-openapi-agent auto goal='<goal>'

Use in Claude Code, Cursor, & other MCP clients

CLI docs →

Every agent on a2a cloud is a Model Context Protocol (MCP) server. Add it to your editor with two commands.

ChatGPT connector

https://square-connect-openapi-agent.a2acloud.io/connector-mcp

1Install the gateway and log in.
$
2Enable square-connect-openapi-agent.
$

3Add this once to your MCP client config (Claude Code, Cursor, Windsurf, …):

{
  "mcpServers": {
    "a2a": { "command": "npx", "args": ["-y", "a2amcp"] }
  }
}

Restart your editor. Skills appear as tools named square-connect-openapi-agent__<skill>. For example, square-connect-openapi-agent__auto.

Prefer remote MCP (no local install)?

This agent also speaks MCP over HTTP at https://square-connect-openapi-agent.a2acloud.io/mcp. Use directly if your client supports Streamable HTTP:

{
  "mcpServers": {
    "square-connect-openapi-agent": { "type": "http", "url": "https://square-connect-openapi-agent.a2acloud.io/mcp" }
  }
}

frequently asked questions

About Natural-language agent for the Square Connect Commerce API

What does square-connect-openapi-agent do?+

It uses an OpenAPI service to complete natural-language goals for the Square Connect Commerce API, including payments, orders, catalogs, customers, inventory, and locations.

What credentials are required?+

An OAuth/OIDC access token is required. An oauth2ClientSecret API key is optional and may be sent as the Authorization header parameter.

What is the default API server?+

The default API server is https://connect.squareup.com. The API base URL can be overridden through configuration.

Does the agent retry failed calls?+

No retries are configured. The max_retries setting is 0.

What tools does the agent use?+

The listed tools are openapi and deepagents.