Overview

Colossal provides a number of core commerce primitives:

• Products
• Cart
• Customers
• Checkout
• Orders

These primitives are designed to seamlessly work with one another, but can also be used as stand-alone services and work with third-party apps or your existing infrastructure.

The core flow is the following:

• Merchant creates and publishes products
• Customers add products to carts
• Checkout is created from those carts
• Customers pay for the products on the Colossal Checkout page
• An order is created after successful payment

At the same time, you can use Colossal Cart and Cart Agents with your own checkout and product services.

Three surfaces

Each of these primitives is exposed across three surfaces and is reachable from each one:

• Actions are typed operations that any agent step invokes directly. Use them in App Action steps when you wire deterministic operations from trigger or step data.
• Tools are LLM-callable functions. Use them when you want an LLM to pick what to call. Most write tools wrap the matching action (so they route through your approval policy). Read tools return shapes tuned for the LLM, sometimes richer than the matching action. For example, get_customer_details includes order_count while the get_customer action does not.
• Storefront API is the public GraphQL surface. Use it from your storefront, an MCP server, or any external client that needs read or mutation access.

Projects

A project is your commerce environment. Each project has its own products, prices, customers, integrations, and agents.

Projects usually have a storefront, but that’s just one of multiple commerce surfaces that will be available. We are working on adding support for agentic protocols, allowing AI agents to discover and purchase products on behalf of users.

Custom domains

When creating a project using chat, Colossal automatically deploys a storefront for it on a free subdomain. But for production stores, we recommend adding your own domain.

You can do this either in the chat or by clicking Edit custom domain in the menu when clicking the Publish button in preview.