Repository avatar
Developer Tools
v1.0.2
active

shop

es.gmartos.aifec/shop

Demo AI-first shop: search products, fill a cart and prepare the order (test payments).

Documentation

AIFEC — AI-First E-Commerce

English · Español

License: Apache 2.0 PHP 7.4–8.4 MCP Registry Live demo

An open, practical way for AI assistants to buy from independent online stores — today, with any LLM, and with a person always in control.

AIFEC is a complete online store (catalogue, cart, checkout, orders, content) that installs on any PHP hosting, like WordPress. It is built so that an AI assistant can find a product, fill a cart and take the buyer to the checkout without guessing — while prices, stock and payment always stay with the store.

Status: beta. The public demo runs the latest code. There are no production stores using it yet.

Why

AI assistants already recommend products, but most of them cannot finish a purchase in an ordinary store. The big platform protocols (Google's UCP, OpenAI's ACP) need onboarding with each platform and today only work in a few countries. AIFEC takes a simpler path that works now:

  • Buying with links — any assistant that can open a URL (plain GET) can buy, step by step. No plugin, connector or browser automation.
  • An MCP server — for assistants that support connectors (Claude, ChatGPT and others), listed in the official MCP Registry.
  • Human in the loop — the assistant prepares the cart; the person confirms with a code the store emails them and pays on the store's own page. The assistant never sees payment details.

It is meant to complement UCP and ACP, not to compete with them: AIFEC also ships a UCP profile (off by default) for when those platforms open to more stores.

Live demo

The demo store has fictional products and brands, and only test payments.

WhatAddress
Storehttps://aifec.gmartos.es/
Buying with links (start here as an assistant)https://aifec.gmartos.es/buy-with-links
MCP server (Streamable HTTP, no key)https://aifec.gmartos.es/mcp
MCP server cardhttps://aifec.gmartos.es/.well-known/mcp/server-card.json
Guide for language modelshttps://aifec.gmartos.es/llms.txt
REST API and OpenAPIhttps://aifec.gmartos.es/api · https://aifec.gmartos.es/openapi.json

Try it: ask your assistant “Find me a tall, narrow bathroom cabinet under 50 € at aifec.gmartos.es and leave it ready to buy.”

How an assistant buys

  1. Find — the store publishes llms.txt, an MCP server card, a product feed and plain HTML pages. Every product page includes the address an assistant opens to buy it.
  2. Fill the cart — with links (/buy-with-links/new/{product}) or with MCP (cart_add). Every answer includes the next addresses or tools, so the assistant never has to invent a URL.
  3. Hand over or confirm — the assistant either gives the person a link that opens the checkout with that cart, or prepares the order: the store emails the buyer a 6-digit code, and the order is placed only when the person gives that code back.
  4. Pay — always on the store's page (card, PayPal, transfer…). Prices, taxes and totals always come from the store.

The full flow is described in Simple Agent Checkout.

What works today

Measured in November 2026 with test customers on the demo store:

AssistantResult
Claude (web)Opens the links, fills the cart and gives the checkout link or places the order with the buyer's code.
ChatGPTWith the AIFEC MCP connector: finds the product, fills the cart and gives the checkout link. Without it, it rarely opens a live store.
GrokFollowed the links to the checkout in our tests.
GeminiDid not reach the checkout in our tests: it answers from Google's index instead of opening the store.

Quick start

Requirements: PHP 7.4 to 8.4 with the usual extensions (pdo, json, mbstring, curl, openssl, dom, gd), and SQLite or MySQL/MariaDB. Nothing else: no Composer, no Node, no extra services.

On a hosting (about 5 minutes):

  1. Download the ZIP from the releases and upload the aifec folder.
  2. Point the web root of your domain to aifec/public.
  3. Open the domain in a browser and follow the three screens: language, database (SQLite needs no setup) and your store.

On your computer (one minute):

git clone https://github.com/ecomyseo/aifec.git && cd aifec
php aifec site:create main --url=http://127.0.0.1:8000 --admin-email=you@example.test --admin-name="Your name"
php -S 127.0.0.1:8000 -t public public/index.php

Then open http://127.0.0.1:8000 (store) and http://127.0.0.1:8000/admin (panel). With SQLite, site:create took one second on a laptop; the MCP server, llms.txt, the API and buying with links work from the first minute.

How it is built

core/        the kernel: request, routes, data, views, admin panel, console
modules/     what ships by default (catalogue, orders, customers, shipping, taxes, content, api, mcp, agentic…)
plugins/     add-ons, under the AIFEC plugin contract
themes/      themes; all inherit from the base theme
public/      the only folder the web server sees
tests/       kernel tests (each module keeps its own)
docs/        documentation
aifec        the console:  php aifec help

Modules, plugins and themes are declared with small files (module.json, hooks.php, routes.php, admin.php, settings.php, theme.json); the admin panel is built from those declarations.

Tests

php tests/run.php              all of them
php tests/run.php modules/mcp  only the ones under that path

They need no network and no database server: every test builds its own site in a temporary folder.

Languages

The code and its source strings are in English, with a complete Spanish translation. The store, the panel and the assistant work in both. The documentation in docs/ is in Spanish for now.

License

Apache License 2.0. Copyright 2026 Ecom Experts.

Contact

Ecom Experts — ecomyseo@gmail.com · https://aifec.gmartos.es/

If you work on agentic commerce, MCP or a store platform and want to talk about this, write to us: we are happy to give a 20-minute demo.

No installation packages available.

Remote