Swipe
The Dispatch
ReleasedFull ReleaseAPI

AI Agent Skills for Commerce APIs

AI coding agents can now connect to the GoDaddy Commerce Platform APIs out of the box. A new skill file shipped with @godaddy/react teaches agents how to authenticate, query Orders, Catalog, Taxes, and Price Adjustments via GraphQL. This builds on the agent-first GoDaddy CLI (github.com/godaddy/cli) — together they enable agentic engineering workflows for building commerce experiences.

@Phil Bennett
ProductEngineeringUX

See It in Action

An AI agent uses the Commerce API skill to authenticate, query the catalog, and build a product listing page — all from a single natural-language prompt.

3 items — click to enlarge

Why This Matters

  • Faster prototyping — engineers and AI agents can scaffold commerce integrations in minutes instead of hours by following the built-in skill guide
  • Lower barrier to entry — no need to hunt through docs for auth flows, endpoint URLs, or schema details. The skill file is the single source of truth
  • Agentic engineering — AI coding tools (Claude, Copilot, Cursor) can autonomously connect to Commerce APIs, introspect schemas, and write working queries
  • Fewer integration mistakes — the skill documents critical pitfalls (missing Bearer prefix, wrong token URL, missing scopes) that commonly trip up both humans and AI agents

What's New

  • 1Shipped a TanStack Intent skill file (`SKILL.md`) with `@godaddy/react` that teaches AI agents how to connect to Commerce Platform GraphQL APIs
  • 2Covers OAuth2 authentication (client credentials grant, token caching, scope management) for both OTE and production environments
  • 3Documents all four GraphQL subgraph endpoints: Orders (11 queries, 17 mutations), Catalog (29 queries, 110 mutations), Taxes (8 queries, 39 mutations), and Price Adjustments (8 queries, 36 mutations)
  • 4Includes working code examples for token acquisition, schema introspection, order queries, catalog queries, tax calculation, and price adjustment calculation
  • 5Documents common mistakes with severity levels (Critical, High, Medium) — missing Bearer prefix, wrong token URL, missing storeId in paths, omitted scopes, expired tokens, and draft order status checks
  • 6Supports automatic discovery via `npx @tanstack/intent list` so agents can find and load the skill without manual setup
  • 7Builds on the agent-first GoDaddy CLI ([github.com/godaddy/cli](https://github.com/godaddy/cli)) — all CLI commands return structured JSON envelopes with `next_actions` suggestions, enabling agents to chain operations programmatically
  • 8CLI includes a skills system and AGENTS.md for agent self-discovery — run `godaddy` with no arguments to get the complete environment snapshot and command tree

Known Limitations

  • Skill covers read and write operations for Orders, Catalog, Taxes, and Price Adjustments — other Commerce APIs (Shipping, Fulfillment) will be added in future updates
  • OAuth app must be provisioned with the appropriate scopes before the agent can access specific APIs
Back to top