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', …)andwindow.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,offerandavailability. - Real-time stock webhook:
POST /api/public/store/webhooksfor 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.