AIFEC

● Active

es.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.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "shop": {
      "url": "https://aifec.gmartos.es/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http shop https://aifec.gmartos.es/mcp
VS Code
code --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
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks 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 →
● Working673 msprotocol 2025-06-18v1.0.0toolsresources

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 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 parameters
    • querystringWhat to look for: the customer's words or, for a vague need, a product type or synonym of your own that fits
    • limitintegerHow many products to return, from 1 to 8
    • category_idintegerOnly products of this category (see list_categories)
    • max_price_centsintegerMaximum price in cents: 5000 means 50.00
    • in_stock_onlybooleantrue: only products that can be bought now
    • 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
  • 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 parameters
    • idintegerrequiredThe id of the product, from search_products
    • 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
  • 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 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
  • 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 parameters
    • product_idintegerrequiredThe id of the product, from search_products
    • variant_idintegerThe id of the variant (colour, size…), from get_product; 0 for a product without variants
    • qtyintegerHow many units
    • 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
  • shipping_quote6 params

    Delivery 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 parameters
    • countrystringISO 3166-1 alpha-2 code, for example ES
    • postcodestringThe postcode of the delivery address
    • product_idintegerThe id of the product, from search_products
    • variant_idintegerThe id of the variant (colour, size…), from get_product; 0 for a product without variants
    • qtyintegerHow many units
    • 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
  • store_info2 params

    About 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 parameters
    • topicstringWhat to tell about the shop; all gives everything
    • 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_view1 param

    The customer's cart: lines, quantities, prices and totals, as the shop calculates them.

    Show 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 params

    Add 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 parameters
    • product_idintegerrequiredThe id of the product, from search_products
    • variant_idintegerThe id of the variant (colour, size…), from get_product; 0 for a product without variants
    • qtyintegerHow many units to add
    • 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_update3 params

    Change the quantity of a cart line (the key comes from cart_view). Quantity 0 removes the line.

    Show parameters
    • keystringrequiredThe key of the cart line, from cart_view
    • qtyintegerrequiredThe new number of units; 0 removes the line
    • 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_link1 param

    The address of the checkout page with the customer's cart, where they review and pay. Payment always happens there.

    Show 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 param

    Where 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 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 params

    Save 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 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, t
    • emailstringThe 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 ga
    • last_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. The
    • vat_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 one
    • 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_shipping_options1 param

    The delivery options for the order with their price and delay, and the one selected. Needs the delivery address first.

    Show 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 params

    Choose the delivery option (carrier_id from checkout_shipping_options).

    Show parameters
    • carrier_idintegerrequiredThe id of the delivery option, from checkout_shipping_options
    • 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_payment_options1 param

    The 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 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 params

    Choose the payment method (method = the id from checkout_payment_options).

    Show parameters
    • methodstringrequiredThe id of the payment method, from checkout_payment_options
    • 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_review1 param

    The 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 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 params

    Place 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 parameters
    • confirm_tokenstringrequiredThe confirm_token of the last checkout_review
    • buyer_confirmedbooleanrequiredtrue: the person has seen the total and said yes
    • buyer_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-httphttps://aifec.gmartos.es/mcp

The most-starred E-commerce & Retail servers in the index, with their live-check result.

ServerStarsLast pushLive check
eBay Seller Tools202Nov 2026Local / not checked
handle-mcp162Nov 2026Local / not checked
Secondhand MCP103Oct 2026Local / not checked
MCP Cn Commerce102Nov 2026Local / not checked
Alza MCP102Nov 2026Local / 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.
Browse all E-commerce & Retail →

Add the badge to your site

Show visitors that AIFEC is listed here — it’s also the link we check for a free listing.

AIFEC — listed on Serverdex

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

[![AIFEC — listed on Serverdex](https://serverdex.io/brand/badge.svg)](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.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/es-gmartos-aifec-shop) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/es-gmartos-aifec-shop) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](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).