Repository navigation
Releases
v1.0.0
First stable release of the OpenMage AI Suite.
What it does
Four capabilities for OpenMage and Magento 1 stores, all running on your own server with your own API key.
MCP server — Connect Claude, ChatGPT, Claude Code or any Model Context Protocol client to your store. 22 tools spanning catalog, inventory, orders, customers, reporting, content and platform introspection, each scoped to an admin role.
Admin copilot — Generate product and category copy from real product attributes, queue bulk generation into a review grid, draft customer-service replies from order data, and ask your store questions from inside the admin.
Storefront assistant — A chat widget that searches the live catalog, quotes the shopper's own prices, surfaces promotions, tracks orders and offers add-to-cart. Works with any theme.
LLM discovery — Product feed in JSON Lines and CSV using the Google Merchant and Agentic Commerce Protocol vocabulary, plus llms.txt and a catalog API so AI shopping agents can read your inventory.
Safety
Nothing is enabled by default. Write operations need a store-wide switch, a write-scoped token and explicit confirmation. Every tool call and model request is audited. API keys are encrypted at rest. Read-only SQL is off by default and heavily constrained when enabled.
Requirements
OpenMage LTS 20.x or 21.x, PHP 8.1 or newer, cURL. Providers: Anthropic, OpenAI or any OpenAI-compatible endpoint, Google Gemini.
Install
composer require magento-hackathon/magento-composer-installer jestr-ai/openmage-ai-suiteOr with modman:
modman clone https://github.com/jestr-ai/openmage-ai-suiteThen flush the cache, log out and back in, and open System > Configuration > AI Suite.
Verified
Tested against a live OpenMage 20.18 store with sample data and a production provider. 35 automated tests cover provider wire formats, schema validation, the JSON-RPC server, SQL guards and permission scoping. CI runs on PHP 8.1 and 8.3.