> ## Documentation Index
> Fetch the complete documentation index at: https://aiodapp.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# What you can build

> The promotions an AI agent can create and manage on your Shopify store through the AIOD MCP server.

Once AIOD is connected, you can describe a promotion in plain language and your assistant will build it — reading AIOD's real rules, checking the result against a simulated cart, and handing you a link to review.

Here is what it can build.

<CardGroup cols={2}>
  <Card title="Automatic discounts" icon="tag" href="/docs/docs/mcp-server/use-cases/automatic-discounts">
    Percentage off, amount off, or a fixed final price — on a product, a collection, or everything.
  </Card>

  <Card title="Free gifts" icon="gift" href="/docs/docs/mcp-server/use-cases/free-gifts">
    Gift with purchase, added automatically or picked by the shopper.
  </Card>

  <Card title="Quantity discounts" icon="chart-no-axes-column-increasing" href="/docs/docs/mcp-server/use-cases/quantity-discounts">
    Volume breaks, spend-more-save-more ladders, and selectable bundle offers.
  </Card>

  <Card title="Buy X Get Y" icon="percent" href="/docs/docs/mcp-server/use-cases/buy-x-get-y">
    BOGO, mix-and-match, and bundles at one flat combined price.
  </Card>

  <Card title="Conditional discounts" icon="workflow" href="/docs/docs/mcp-server/use-cases/conditional-discounts">
    Rules based on customer, country, date, or cart contents — plus exclusions.
  </Card>
</CardGroup>

## Beyond creating offers

Your assistant can also:

* **Look up what you're running.** "What discounts are live right now?" — and then explain any of them in detail, which is usually what answers "why isn't this applying at checkout?"
* **Change existing discounts.** "Raise the free shipping threshold to \$75." It reads the current setup and patches just that field.
* **Report performance.** "How much did the BOGO make in June?" — orders, revenue, margin given away, average order value, and a chart series.
* **Schedule promotions.** Dates are part of a discount, so a seasonal sale can be built now and dated for later.
* **Answer setup questions.** Stacking, widgets, POS behaviour, troubleshooting — it searches these docs.

## What it can't build

* **Discount codes.** AIOD's tools cover automatic discounts only. Codes, and anything you made directly in Shopify or with another app, are invisible to it.
* **Anything live.** It can create discounts in test mode, but only you can switch one on.
* **Deletions.** It can't remove a discount.
* **[Upsell widgets](/docs/templates/upsell).** That template has to be set up by hand.

It also can't read your orders, customers, or products.

## How a promotion gets built

Whatever you ask for, the same thing happens under the hood:

1. **Find** the discount, if you're changing an existing one.
2. **Read AIOD's rules** — the templates and field shapes.
3. **Read the current setup**, if you're changing something.
4. **Draft it** — validated and cart-simulated, then staged. You get a link.
5. **Create it**, only if you asked. Real Shopify discount, test mode.

The [Examples](/docs/mcp-server/examples) page walks through real requests end to end. If you're building your own agent, the [Agent guide](/docs/mcp-server/agent-guide) has the full workflow.