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

# Quickstart

> Get up and running with ToeBox in under 10 minutes

Follow these steps to install ToeBox, create your first AI agent, and deploy a chatbot on your Shopify storefront.

<Steps>
  <Step title="Install from the Shopify App Store">
    Search for **ToeBox** in the [Shopify App Store](https://apps.shopify.com) and click **Install**. ToeBox will be added to your Shopify admin sidebar.

    After installation, you will land on the ToeBox dashboard. Your store is automatically connected -- no additional Shopify configuration is needed.

    <Tip>All paid plans include a **14-day free trial**. You will not be charged until the trial ends.</Tip>
  </Step>

  <Step title="Create your first agent">
    Navigate to **Agents** in the sidebar and click **Create Agent**.

    1. Give your agent a name (e.g., "Support Bot").
    2. Select an agent type. **Customer Support** is a great starting point.
    3. Choose a model. **Claude Sonnet 4.6** is the default and recommended for most use cases.
    4. Write a system prompt describing how the agent should behave, or use the auto-generated default.
    5. Click **Save**.

    <Note>You can adjust temperature, max tokens, and other settings later from the agent detail view.</Note>
  </Step>

  <Step title="Configure Shopify MCP tools">
    While editing your agent, open the **MCP Tools** section.

    * **Shopify Catalog** -- Lets your agent search products, retrieve details, and filter by price and availability.
    * **Shopify Checkout** -- Lets your agent create checkout sessions and complete purchases.

    Toggle on the tools you need and click **Save**. ToeBox connects to Shopify's official MCP servers automatically.
  </Step>

  <Step title="Test your agent">
    Click the **Test** button on your agent card. A test chat panel opens where you can send messages and see how your agent responds.

    Try asking something like:

    ```
    What sneakers do you have under $100?
    ```

    The agent will use its connected Shopify tools to search your catalog and respond.
  </Step>

  <Step title="Deploy a chatbot widget">
    Navigate to **Chatbot** in the sidebar and click **Create Chatbot**.

    1. Name your chatbot and select the agent you just created.
    2. Customize the widget appearance -- colors, bubble style, position, and welcome message.
    3. Add suggested prompts that visitors will see when they open the chat.
    4. Click **Save**.

    ToeBox automatically injects the chat widget on your Shopify storefront. No theme code editing required.
  </Step>

  <Step title="View analytics">
    Navigate to **Analytics** in the sidebar. Here you can:

    * Create dashboards with charts, KPIs, and tables
    * Write SQL queries against connected data sources
    * Use the AI Assistant to ask data questions in plain English

    <Tip>The AI Assistant can generate charts from natural language questions and export them directly to your dashboards.</Tip>
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Agent Tools" icon="wrench" href="/guides/agent-tools">
    Learn about MCP tools, custom SQL tools, and the custom tool builder.
  </Card>

  <Card title="Chatbot Customization" icon="palette" href="/guides/chatbot-customization">
    Fine-tune your widget with custom colors, CSS, and branding.
  </Card>

  <Card title="Bring Your Own Key" icon="key" href="/guides/byok">
    Use your own API keys from Anthropic, OpenAI, or OpenRouter.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Integrate ToeBox programmatically with the REST API.
  </Card>
</CardGroup>
