AIFEC
● Activees.gmartos.aifec/shop
Demo AI-first shop: search products, fill a cart and prepare the order (test payments).
Connect this server
One click to install, or copy the config below. Suits: Cursor · HTTP clients.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"shop": {
"url": "https://aifec.gmartos.es/mcp"
}
}
}claude mcp add --transport http shop https://aifec.gmartos.es/mcpcode --add-mcp '{"name":"shop","type":"http","url":"https://aifec.gmartos.es/mcp"}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- E-commerce & Retail
- Version
- 1.0.2
- Registry
- active
- Published
- 11/17/2026
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Looks healthy: AIFEC is maintained, open source, hosted endpoint answering without a key.
- Maintained
- Active
- Last commit 4 days ago (Nov 18, 2026), 0 open issues.
- Official registry
- Active
- Published as es.gmartos.aifec/shop in the official MCP registry, version 1.0.2.
- Source
- Open source, Apache-2.0
- Public repository under the Apache-2.0 licence, 0 stars, 0 forks.
- Runs
- Hosted by the publisher
- Your client talks to aifec.gmartos.es: prompts and tool arguments leave your machine for that host.
- Credentials
- None needed to connect
- The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
- Owner
- Unclaimed
- Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.
Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.
Live check
checked Nov 22, 2026, 00:07 UTCStatus history & uptime →The endpoint answered the MCP handshake as "AIFEC" and listed 18 tools. Answering since Nov 18, 2026.
Context cost ≈ 4.7k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 18 tools.
Tools (18)
- search_products6 params
Search the shop catalogue. Give words (query), a category, a maximum price in cents or only products in stock. Returns up to 8 products (id, name, price_formatted, available, summary, options such as colour or size) and answer_kind: exact (they match), relaxed or related (NOT exact: only the closest, say so), shop (a question about the shop, see shop_answer) or none (nothing matches: say so, never offer unrelated products).
Show parametersHide parameters
querystringWhat to look for: the customer's words or, for a vague need, a product type or synonym of your own that fitslimitintegerHow many products to return, from 1 to 8category_idintegerOnly products of this category (see list_categories)max_price_centsintegerMaximum price in cents: 5000 means 50.00in_stock_onlybooleantrue: only products that can be bought nowsession_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
- get_product2 params
Everything the shop says about one product: description in plain text, key facts, the options (colour, size) with their available values, variants with price and availability, delivery time and frequently asked questions. Call it whenever the customer asks about a product ("tell me about it", "what is it", "features") and answer with what it says.
Show parametersHide parameters
idintegerrequiredThe id of the product, from search_productssession_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
- list_categories1 param
The product categories of the shop with their sub-categories (what the shop sells), and popular: the categories of the best sellers, first the one that sells most.
Show parametersHide parameters
session_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
- check_availability4 params
Whether a product (or one of its variants) can be bought in a given quantity right now, and what that quantity costs: unit_price and total (unit price × quantity, calculated by the shop). When the customer asks how much several units cost, call it with that qty and say its total: never multiply yourself.
Show parametersHide parameters
product_idintegerrequiredThe id of the product, from search_productsvariant_idintegerThe id of the variant (colour, size…), from get_product; 0 for a product without variantsqtyintegerHow many unitssession_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
shipping_quote6 paramsDelivery options, prices and times to a destination. Give the postcode (and the 2-letter country if it is not the shop's own). Quotes the product given, or the current cart when no product is given.
Show parametersHide parameters
countrystringISO 3166-1 alpha-2 code, for example ESpostcodestringThe postcode of the delivery addressproduct_idintegerThe id of the product, from search_productsvariant_idintegerThe id of the variant (colour, size…), from get_product; 0 for a product without variantsqtyintegerHow many unitssession_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
store_info2 paramsAbout the shop itself and its policies: what the shop is and sells in its own words (about), returns (the deadline and the text of the returns page, with its link), shipping and terms pages, accepted payment methods, how the invoice reaches the customer (invoices), contact details and opening hours. Call it for any question about the shop that is not about a product. Say you do not know only when this returns nothing for the topic.
Show parametersHide parameters
topicstringWhat to tell about the shop; all gives everythingsession_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
cart_view1 paramThe customer's cart: lines, quantities, prices and totals, as the shop calculates them.
Show parametersHide parameters
session_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
cart_add4 paramsAdd units of a product to the customer's cart. The price is always the shop's own; it cannot be given. A product with variants needs its variant_id: without it you get need=options with the choices (the shop shows them as buttons): ask which one the customer wants and call again with that variant_id. If the product is already in the cart it returns already_in_cart and adds nothing (unless the customer asked for more in this message): to change how many there are, use cart_update with the exact number. Keep the returned session_id for all later cart and checkout calls. If your client cannot pass it, give the buyer checkout_url from this result to continue with the same cart.
Show parametersHide parameters
product_idintegerrequiredThe id of the product, from search_productsvariant_idintegerThe id of the variant (colour, size…), from get_product; 0 for a product without variantsqtyintegerHow many units to addsession_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
cart_update3 paramsChange the quantity of a cart line (the key comes from cart_view). Quantity 0 removes the line.
Show parametersHide parameters
keystringrequiredThe key of the cart line, from cart_viewqtyintegerrequiredThe new number of units; 0 removes the linesession_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
checkout_link1 paramThe address of the checkout page with the customer's cart, where they review and pay. Payment always happens there.
Show parametersHide parameters
session_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
checkout_status1 paramWhere the purchase is: what is still missing (contact, address, shipping, payment, in the order to ask for it), the cart summary and what is already saved. Personal data come masked. Call it before asking the customer anything about their order.
Show parametersHide parameters
session_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
checkout_set_customer16 paramsSave the customer's details for this order. Pass every detail in its OWN field, already separated: first_name, last_name, email, phone, line1 (street and number), line2 (floor and door), postcode, city, region, country, company and vat_id. Put only the value in each field, never the label or the sentence around it. Use text only as a last resort, when you cannot tell the details apart. It saves what is valid and returns what it understood, what is wrong and what is still missing. Never invent a value: ask for what was not said.
Show parametersHide parameters
textstringONLY if you cannot separate the details into the fields: what the customer wrote about themselves, exactly as they wrote it. When you pass any separate field, temailstringThe email address, nothing else. Only if the customer gave it.first_namestringThe first name of the person, nothing else. Never a greeting, a yes or a label: "Yes", "Ok", "Hello", "Address" or "Name" are not names. Only if the customer galast_namestringThe surname or surnames, nothing else. Only if the customer gave it.companystringThe company name ONLY when a company buys and needs the invoice in its name ("Invoice to company X", "Factura a nombre de X"); then vat_id is required too. Thevat_idstringThe tax or VAT ID exactly as given (keep a country prefix such as "ES"), without the label. Only if the customer gave it.phonestringThe phone number, digits and an optional + prefix. Only if the customer gave it.line1stringStreet and number only ("Calle Mayor 1", "Carrer de l'Exemple 9"), without the word "address", the floor or the postcode. Only if the customer gave it.line2stringFloor, door or staircase only ("3º A", "2n 1a", "bajo"), if given. Only if the customer gave it.postcodestringThe postcode only. Only if the customer gave it.citystringThe city or town only. Only if the customer gave it.regionstringThe province or region, only if given. Only if the customer gave it.countrystringISO 3166-1 alpha-2 code ("ES" for Spain). Only if the customer gave it.address_idintegerOne of the saved_addresses ids of checkout_status (customers with an account)notestringA note for the order, only if the customer asked for onesession_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
checkout_shipping_options1 paramThe delivery options for the order with their price and delay, and the one selected. Needs the delivery address first.
Show parametersHide parameters
session_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
checkout_set_shipping2 paramsChoose the delivery option (carrier_id from checkout_shipping_options).
Show parametersHide parameters
carrier_idintegerrequiredThe id of the delivery option, from checkout_shipping_optionssession_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
checkout_payment_options1 paramThe payment methods offered for the order, with their kind (offline: transfer or cash on delivery; redirect: paid online) and any fee, and the one selected.
Show parametersHide parameters
session_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
checkout_set_payment2 paramsChoose the payment method (method = the id from checkout_payment_options).
Show parametersHide parameters
methodstringrequiredThe id of the payment method, from checkout_payment_optionssession_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
checkout_review1 paramThe exact order that would be placed: lines, discounts, shipping, taxes, the total (total_cents and total formatted), the delivery address and the payment method, and the confirm_token that checkout_place needs. Read the total from here: never calculate it. If something is missing it says what. When no API key with the scope orders:create is sent, the shop emails a 6-digit verification code to the buyer for security and says so in "confirmation": tell the person, ask for the code and wait for it.
Show parametersHide parameters
session_idstringOnly if your client does not keep the MCP session (the Mcp-Session-Id header): the session_id that an earlier answer of this server gave you. It keeps the same
checkout_place3 paramsPlace the order. Needs the confirm_token of the last checkout_review, buyer_confirmed true (you declare that the person has seen the total and said yes) and one of two things: buyer_code, the 6-digit verification code that the shop emails to the buyer when you call checkout_review (ask the person for it and wait: never guess it), or an API key with the scope orders:create, sent as Authorization: Bearer. Without them nothing is placed. If anything changed after the review, the confirm_token is no longer valid: review again. The person pays: the answer says how.
Show parametersHide parameters
confirm_tokenstringrequiredThe confirm_token of the last checkout_reviewbuyer_confirmedbooleanrequiredtrue: the person has seen the total and said yesbuyer_codestringThe 6-digit code the shop emailed to the buyer after checkout_review. Not needed with an API key that has the scope orders:create
Checked by Serverdex with a plain initialize + tools/list call to aifec.gmartos.es/mcp, no credentials, about once a day. A failed check is never a removal.
On GitHub
read Nov 18, 2026- Stars
- 0
- Forks
- 0
- Last push
- Nov 18, 2026
- License
- Apache-2.0
PHPagentic-commerceai-agentsecommercellms-txtmcpmodel-context-protocolopenapiphpshop
From the README
AIFEC — AI-First E-Commerce English · Español 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.…
Read the full README on GitHub →Remotes
- streamable-http
https://aifec.gmartos.es/mcp
Alternatives to AIFEC
All AIFEC alternatives →Best E-commerce & Retail servers →The most-starred E-commerce & Retail servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| eBay Seller Tools | 202 | Nov 2026 | Local / not checked |
| handle-mcp | 162 | Nov 2026 | Local / not checked |
| Secondhand MCP | 103 | Oct 2026 | Local / not checked |
| MCP Cn Commerce | 102 | Nov 2026 | Local / not checked |
| Alza MCP | 102 | Nov 2026 | Local / not checked |
AIFEC: questions people ask
- Is AIFEC a remote or a local MCP server?
- According to its entry in the official MCP registry, AIFEC ships as a hosted endpoint (streamable-http) that your client connects to by URL.
- Does AIFEC need an API key?
- Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
- Is AIFEC safe to use?
- Looks healthy: AIFEC is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, Apache-2.0; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
- Is AIFEC still maintained?
- Active: the repository's last commit 4 days ago. Last push Nov 18, 2026, 0 GitHub stars, Apache-2.0 licence. Read from GitHub on Nov 18, 2026.
- What tools does AIFEC expose?
- 18 tools as listed by the server itself during the live check, including search_products, get_product, list_categories, check_availability, shipping_quote. The full list with parameters is in the Live check section above.
- How do I add AIFEC to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More E-commerce & Retail servers
Browse all E-commerce & Retail →iwant.fyi - shop, price-check and keep looking
staugs
No key needed. Search real products and live dealer inventory, price-check, keep standing wants.
SIGNALS Loyalty Agent Platform
psxio
63 MCP tools for loyalty programs, rewards, and member operations with HITL approval.
BestPrice
TheBestCo
Read-only shopping decisions, product search, offers, and price history for Greece.
Open Shopping Agent
browsa-io
Shopping agent: compares Amazon, Walmart, eBay, Best Buy, Target, Shopify; buys only with your OK
CarChat Inventory
Carchat-io
Search live US dealership inventory, get market prices, and send buyer inquiries. Free, no API key.
Crossmart
crossmart-io
Run a multichannel catalog: products, stock, store listings on Shopify and eBay.
Add the badge to your site
Show visitors that AIFEC is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/es-gmartos-aifec-shop?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="AIFEC — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/es-gmartos-aifec-shop?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Install buttons — for your README
[](https://serverdex.io/install/cursor/es-gmartos-aifec-shop) [](https://serverdex.io/install/vscode/es-gmartos-aifec-shop) [](https://serverdex.io/install/claude-code/es-gmartos-aifec-shop)One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.
Install buttons — HTML for your docs
<a href="https://serverdex.io/install/cursor/es-gmartos-aifec-shop"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/es-gmartos-aifec-shop"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/es-gmartos-aifec-shop"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>Same buttons as plain links for a docs page or website.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).