AxG AI Developer Documentation

Technical specification for the embed script, MCP server (Model Context Protocol) and machine-readable catalog APIs.

1. Embed Script & JavaScript API

Add the AI chat to any website (Shopify, WooCommerce, Wix, Squarespace or custom code) with one line of HTML.

Code example

<script
  src="https://ai.axelsson.graphics/embed/axg-chat.js"
  data-agent-id="axg_ag_10482"
  data-client-slug="demo-store"
  data-theme="auto"
  data-color="#10b981"
  data-position="bottom-right"
  async>
</script>

Parameters

  • data-agent-id — your unique Agent ID, received at sign-up.
  • data-client-slug — unique store handle for billing and an isolated data context.
  • data-theme — auto | light | dark, adapts to the visitor's device.
  • data-color — accent color as HEX. data-position — launcher position.
  • JS events: window.addEventListener('axg:chat_opened', …) and window.addEventListener('axg:product_added_to_cart', …).

2. Model Context Protocol (MCP) Server

A standard MCP server that lets AI agents (Claude Desktop, Cursor, Antigravity, custom LLMs) work directly with your store's catalog and order handling.

Code example

{
  "mcpServers": {
    "axg-ai-sales": {
      "command": "npx",
      "args": [
        "-y",
        "@axelsson-ai/mcp-server",
        "--agent-id=axg_ag_10482",
        "--api-key=YOUR_API_KEY"
      ]
    }
  }
}

Tools

  • search_catalog — search the product catalog by keyword, category or image vectors.
  • get_order_status — sanitized order and package tracking status via Order ID + email.
  • get_stock_levels — exact stock and availability for a specific SKU/variant.
  • escalate_ticket — create an escalation ticket directly in Support Studio.

Website MCP (no login)

Agents can also discover products and start a free trial via https://axelsson.graphics/mcp — tools list_chatbots, get_install_instructions, request_free_trial and verify_free_trial.

3. Machine-Readable Catalog & OpenAPI Schema

RESTful JSON-LD and OpenAPI endpoints for continuous indexing, vector search and third-party integrations.

Code example

GET https://ai.axelsson.graphics/api/public/store/catalog.json?agent_id=axg_ag_10482

Headers:
  Accept: application/json
  Authorization: Bearer YOUR_API_TOKEN

Specification

  • JSON-LD: each product is returned as Schema.org/Product with featuredImage.url, priceCurrency, offer and availability.
  • Real-time stock webhook: POST /api/public/store/webhooks for instant sync on stock changes.
  • Filters: price_min, price_max, category, in_stock_only, visual_vector_search.

Our own product and pricing data: https://axelsson.graphics/api/public/catalog.json and https://axelsson.graphics/llms.txt.

Data & privacy

Data is processed in the EU, requests are signed with HMAC, and no personal identity numbers are collected. See the privacy policy for details.
Open AI assistant