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

# Nova AI Assistant

> Your AI-powered store management assistant built into LaunchMyStore

# Nova AI Assistant

Nova is an AI assistant built directly into your LaunchMyStore admin dashboard. It helps you manage your store through natural language conversations.

<Note>
  **Nova and MCP share the same tools.** Nova is for in-dashboard use, while [MCP](/mcp/overview) is for external AI clients like Claude Desktop. Both use identical tool definitions — see [Tools Reference](/nova/tools).
</Note>

## What Nova Can Do

Nova ships with \~160 built-in tools across 35 categories. Highlights:

<CardGroup cols={2}>
  <Card title="Products & Variants" icon="box">
    "Add a Summer T-Shirt for \$29.99 with sizes S/M/L"
  </Card>

  <Card title="Orders & Fulfillment" icon="receipt">
    "Mark order #1234 as shipped" or "Refund this order"
  </Card>

  <Card title="Analytics & Insights" icon="chart-line">
    "How did we do this week?" or "Best-selling product this month?"
  </Card>

  <Card title="Coupons & Discounts" icon="tag">
    "Create SUMMER25 — 25% off, weekend only"
  </Card>

  <Card title="Customers" icon="users">
    "Find repeat customers from New York"
  </Card>

  <Card title="Content (AI)" icon="file-lines">
    "Write a blog post about summer fashion trends"
  </Card>

  <Card title="Themes & Files" icon="palette">
    "Change header to blue" or "Add a hero section to the homepage"
  </Card>

  <Card title="Store Settings" icon="gear">
    "Free shipping over \$50" or "Enable guest checkout"
  </Card>

  <Card title="Apps & Functions" icon="puzzle-piece">
    "List installed apps" or "Test the discount function"
  </Card>

  <Card title="Metafields" icon="database">
    "Set the warranty\_years metafield to 5 on this product"
  </Card>

  <Card title="Agents & Automations" icon="robot">
    "Email a thank-you note when any order is placed"
  </Card>

  <Card title="POS & Shifts" icon="cash-register">
    "Open a register shift" or "List today's shifts"
  </Card>
</CardGroup>

## Getting Started

Nova is available in your admin dashboard. Look for the AI assistant icon in the bottom-right corner or press `Cmd+K` / `Ctrl+K`.

### Example Conversations

**Managing Products:**

```
You: Add a product called "Classic Hoodie" priced at $49.99
Nova: ✓ Product created! "Classic Hoodie" is now in your store at $49.99.

You: Set stock to 50 units
Nova: ✓ Updated stock to 50 units for "Classic Hoodie"
```

**Checking Analytics:**

```
You: How's the store doing this week?
Nova: This week's performance:
      • Revenue: $4,230 (+15% vs last week)
      • Orders: 47 orders
      • Average order: $90
      • Top product: Summer Dress (12 sold)
```

**Creating Discounts:**

```
You: Create a 25% off code SUMMER25 valid until end of month
Nova: ✓ Coupon created!
      Code: SUMMER25
      Discount: 25% off
      Expires: June 30, 2025
```

## Nova vs MCP

| Feature   | Nova (In-Dashboard)                   | MCP (External)                            |
| --------- | ------------------------------------- | ----------------------------------------- |
| Where     | Admin dashboard                       | Claude Desktop, Cursor, Claude Code, etc. |
| Auth      | Automatic (logged-in session)         | 1-year MCP token (`/mcp/token`)           |
| Streaming | Real-time SSE responses               | Depends on the client                     |
| Tools     | \~160 shared definitions              | Same set (every tool is dual-exposed)     |
| Credits   | Charged from your Nova credit balance | Charged from your Nova credit balance     |

## Capabilities by Category

### Products & variants

* Search, list, filter, sort products
* Add/update/delete products (including variants)
* Add/update/delete individual variants
* List the (option-name, option-value) pairs across the store

### Orders & fulfillment

* List orders with status/payment/date/customer filters
* Look up a single order in detail
* Update status, tracking number, courier, delivery date
* Create manual orders (admin-side checkout)
* Refund orders
* List abandoned carts

### Analytics

* Dashboard summary (revenue, orders, AOV, traffic)
* Sales analytics with breakdowns and trends
* Traffic analytics (sessions, sources, page views)
* Product analytics (views, ATC, conversion)

### Categories

* List/search categories
* Create, update, delete categories
* Assign products to one or more categories

### Coupons

* List coupons
* Create coupons (Percentage, Flat, BuyXGetY, FreeShipping, Freebie)
* Update / delete / deactivate coupons

### Customers

* Search and list customers
* Add, update, delete customers
* View per-customer purchase history through orders

### Blogs & pages

* Create/update/delete blog posts (with SEO fields)
* Create/update/delete custom pages
* List blogs and pages with search

### Themes

* List themes; set the active theme
* Read/save theme settings
* Browse template sections; add/delete sections
* Reorder sections
* Add/delete blocks inside sections
* List/read available section types and their schemas
* Direct **theme file editor**: list / read / write / delete / rename
  any file under `sections/`, `snippets/`, `blocks/`, `assets/`,
  `templates/`, `layout/`, `config/`, `locales/` (text up to 5 MB,
  binaries up to 10 MB under `assets/` only)
* Convenience wrappers to create snippets, sections, blocks

### Menus

* List header/footer menus
* Add, update, delete menu items
* Link items to pages, products, categories, or custom URLs

### Shipping & shipping zones

* Read/update flat or variable shipping rates
* Free-delivery thresholds
* Manage shipping zones (countries, rates per zone)

### Store settings

* Store/business info (name, contact, address)
* Checkout settings (guest checkout, custom fields)
* Preferences (auto-accept orders, notifications, sender email)
* Newsletter subscriber list
* Staff list and removal
* Socials (Instagram, Facebook, etc.)

### Taxes

* Read/update tax settings
* Manage sales-tax rules
* Manage tax classes

### Content (AI)

* `write_content` — marketing copy, descriptions, blog posts, emails,
  ads, social
* `generate_product_description` — polished AI product copy
* `rewrite_for_seo` — keyword-target a piece of text
* `summarize_reviews`, `chat_with_data`, `dashboard_insight`,
  `nightly_briefing`, `image_to_listing`

### Media

* List the media library
* Delete media files

### Reviews

* List reviews; AI-summarize them

<Note>
  Store policies (Privacy Policy, Refund Policy, Terms & Conditions) have no
  dedicated tool. Create and edit them as custom **pages** with `add_page` /
  `update_page`, then link them from the footer with `add_menu`.
</Note>

### Selling plans

* Create/update/delete selling-plan groups (subscriptions, deposits)
* Attach selling plans to products

### Payments

* List payment providers
* Add / delete payment providers

### Warehouses

* List warehouses
* Add, update, delete warehouses

### Webhooks

* List, add, update, delete webhook subscriptions

### Notifications

* List in-app notifications
* Delete individual notifications

### POS (Point of Sale)

* Open / close register shifts
* List shifts and current shift state

### Apps & functions (developer ecosystem)

* List installed apps and marketplace apps
* Install/uninstall apps
* Create / update / delete developer apps and extensions
* Upload, test, and delete app functions
* Submit apps for review
* Regenerate app secrets

### Metafields

* Create metafield definitions
* Read / write / delete metafield values across all 9 owner types
  (shop, product, variant, collection, customer, order, page, blog, article)

### Credits & billing

* View Nova credit balance & history
* Top up credits (Spark, Boost, Studio add-on packs)
* View active subscription, history, and cancel

### Leaderboard

* Top stores / top staff by sales (admin context)

### Agents (automations)

* `approve_and_execute` — stage destructive actions behind an approval gate
* `schedule_task` — cron / one-shot future executions
* `subscribe_to_event` — trigger a tool when a store event fires
  (e.g. `orders/create`)

For the full parameter list of every tool, see [Nova Tools Reference](/nova/tools)
or [MCP Tools Reference](/mcp/tools) — both pages describe the same
shared catalog.

## Usage Limits

Nova usage is gated **solely by your Nova credit balance** — unless you
supply your own LLM API key, which bypasses the credit gate entirely.

### 1. Credit balance (the gate)

Every tool call costs **10 Nova credits**. If your balance drops below
10 you can't run another tool until you top up.

Each plan ships with a credit allowance that's refilled on activation
or renewal:

| Plan     | Credits / refill | ≈ tool calls per refill |
| -------- | ---------------- | ----------------------- |
| Trial    | 100              | 10                      |
| Starter  | 500              | 50                      |
| Gold     | 1,000            | 100                     |
| Platinum | 2,000            | 200                     |

There is no per-plan daily message cap or turn limit — the only thing
that stops a tool call is running out of credits.

### 2. Add-on credit packs

Top up your credit balance any time with a Nova credit add-on
subscription. Three tiers, monthly or annual:

| Tier                | Credits / month | Price / month |
| ------------------- | --------------- | ------------- |
| Spark               | 2,000           | \$9           |
| Boost (recommended) | 12,000          | \$39          |
| Studio              | 50,000          | \$99          |

Annual cadence ships 12× credits for 10× the price (≈17% off).

### Bring-your-own LLM key

Add an OpenAI or Anthropic key in *Store Settings → Preferences* and
Nova will use it instead of platform credits. With a BYO key:

* No Nova credits are deducted.
* You pay your model provider directly for tokens.

## Tips for Best Results

1. **Be specific**: "Add a blue cotton t-shirt for \$25" works better than "add a product"
2. **Use context**: Nova remembers the conversation, so you can say "set its price to \$30" after adding a product
3. **Ask for help**: "What can you do?" shows available capabilities
4. **Batch requests**: "Add products: Red Shirt $20, Blue Shirt $22, Green Shirt \$18"

## Streaming Responses

Nova supports real-time streaming, showing you:

* What tool it's using (e.g., "Searching products...")
* Progress updates for long operations
* Results as they become available

## See Also

* [Nova Tools Reference](/nova/tools) - Complete list of available tools
* [MCP Integration](/mcp/overview) - Use the same tools in Claude Desktop
