{"$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","name":"es.gmartos.aifec/shop","title":"AIFEC","description":"The online shop AIFEC: search the catalogue, fill a cart and prepare the order. The person confirms it with a code the shop emails them and pays on the page of the shop.","version":"1.0.0","websiteUrl":"https://aifec.gmartos.es/","protocolVersions":["2025-06-18","2025-03-26","2024-11-05"],"remotes":[{"type":"streamable-http","url":"https://aifec.gmartos.es/mcp"}],"authentication":{"required":false},"icons":[{"src":"https://aifec.gmartos.es/mcp/icon.svg","mimeType":"image/svg+xml","sizes":["any"]}],"tools":[{"name":"search_products","description":"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)."},{"name":"get_product","description":"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."},{"name":"list_categories","description":"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."},{"name":"check_availability","description":"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."},{"name":"shipping_quote","description":"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."},{"name":"store_info","description":"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."},{"name":"cart_view","description":"The customer's cart: lines, quantities, prices and totals, as the shop calculates them."},{"name":"cart_add","description":"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."},{"name":"cart_update","description":"Change the quantity of a cart line (the key comes from cart_view). Quantity 0 removes the line."},{"name":"checkout_link","description":"The address of the checkout page with the customer's cart, where they review and pay. Payment always happens there."},{"name":"checkout_status","description":"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."},{"name":"checkout_set_customer","description":"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."},{"name":"checkout_shipping_options","description":"The delivery options for the order with their price and delay, and the one selected. Needs the delivery address first."},{"name":"checkout_set_shipping","description":"Choose the delivery option (carrier_id from checkout_shipping_options)."},{"name":"checkout_payment_options","description":"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."},{"name":"checkout_set_payment","description":"Choose the payment method (method = the id from checkout_payment_options)."},{"name":"checkout_review","description":"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."},{"name":"checkout_place","description":"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."}],"documentation":"https://aifec.gmartos.es/llms.txt"}