Skip to main content
Glama
Storewire Lite

Storewire Lite

by trongio

Storewire Lite

Let AI assistants read your Laravel store's catalogue. Storewire Lite adds a read-only Model Context Protocol server to your app, built on the official laravel/mcp, with two tools:

Tool

What a shopper's assistant gets

search_products

Search by words or model number, category, brand, price range, in-stock only and spec filters; sorted; paged. Each hit is a product card (page URL, photo, price, stock line, key specs, category), plus the total, a link to the same results on your site, suggested filters and "did you mean" when nothing matched.

get_product

One product as its page shows it: photos, price, stock, the spec table, warranty, plain-text description, documents, the category trail, similar products and what goes with it. Found by id, URL, slug or model number.

You implement one interface over your own models. Nothing is written, nothing is ordered, nothing leaves your catalogue except what a visitor could already see.

Free and MIT licensed.

See the full Storewire running on a demo store: https://demo.plugins.hackerman.ge (point an assistant that supports remote MCP servers at https://demo.plugins.hackerman.ge/mcp).

Install

composer require hackerman/storewire-lite
php artisan vendor:publish --tag=storewire-lite-config

Requirements: PHP 8.3+, Laravel 12.41+ or 13, laravel/mcp 1.2+.

Related MCP server: shop-mcp

Connect your catalogue

Implement Hackerman\StorewireLite\Contracts\CatalogRepository and bind it:

use Hackerman\StorewireLite\Contracts\CatalogRepository;

$this->app->singleton(CatalogRepository::class, App\Mcp\MyCatalog::class);
interface CatalogRepository
{
    // An id from an earlier answer, a product URL or slug, a model number or SKU; null when nothing visible matches.
    public function resolve(string $reference, string $locale): ?string;

    // One product as its page shows it; null when a visitor may not see it.
    public function product(string $id, string $locale): ?ProductDetail;

    public function search(SearchQuery $query): SearchResult;
}

The data objects (ProductCard, ProductDetail, SearchQuery, SearchResult, Price, Availability and friends) are small readonly classes in Hackerman\StorewireLite\Data. Give each card its guest price; a card without one answers with the amount null.

Then switch the server on:

STOREWIRE_LITE_ENABLED=true
STOREWIRE_LITE_SERVER_NAME="Your Store"
STOREWIRE_LITE_CURRENCY=USD

It answers POST /mcp (Streamable HTTP, throttled per client) and runs over stdio with php artisan mcp:start storewire-lite. Try it:

curl -s http://localhost:8000/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-06-18' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"tent"}}}'

Configuration

config/storewire-lite.php: the switch, path, server name and instructions, currency, answer locales, your search page URL (search_url, with an optional {query} placeholder), the per-minute budget per client, and the answer size limits.

Storewire Lite or Storewire

Lite lets an assistant find and describe your products. Storewire lets it sell them: the shopper goes from a question to a filled cart on your own site without leaving the conversation.

Lite (free)

Storewire

search_products, get_product

yes

yes

Cart handoff: cart_add_item, cart_update_item, cart_remove_item, cart_view, with a cart_url that opens your own cart page with the products in it

yes

compare_products side by side, with the better value marked

yes

check_compatibility (does this fit that, what goes with this)

yes

list_categories, find_documents (manuals, datasheets)

yes

get_store_info (stores, hours, payment, returns, FAQ) and get_delivery_options (fees, free-delivery threshold, same day)

yes

Interactive widgets that draw product cards, comparisons and the cart inside the assistant (MCP Apps)

yes

storewire:manifest: the app manifest assistant directories ask for

yes

Response size budget, per-tool throttles, call metrics, translatable answers, your own tools on the same server

yes

Lite's CatalogRepository is a subset of Storewire's: same method signatures, same data objects. Upgrading means switching the namespace and adding the remaining methods; nothing you wrote for Lite is thrown away.

See it working and get Storewire at plugins.hackerman.ge.

Testing

composer test
composer analyse

License

MIT. See LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables an LLM agent to query a Shopify store's catalogue and stock via MCP, with tools for product search, product details, per-location inventory, and low-stock reports.
      4
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables an AI agent to look up products by exact ID or browse them by collection, and to check an order's status with each line item resolved to its full product details in a single call. Returns structured JSON with pricing, stock, and shipping data, and surfaces graceful error results for unknown IDs.
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Turns an online store's catalog into MCP tools so agents can search products, fetch details, look up barcodes, analogs, categories, promotions and pickup points, and hand off a cart as a payment link rather than checking out. It is driven by a single TOML config with capability-based tool sets, bilingual model-facing texts, public catalog access plus OAuth 2.1-scoped personal tools like order history, and ready adapters for YML/Google Merchant feeds and WooCommerce across ten store engine presets.
      Apache 2.0