Demo AI-first shop: search products, fill a cart and prepare the order (test payments).
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Only 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 between calls.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http shop https://aifec.gmartos.es/mcp
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.
| Argument | Type | Description |
|---|---|---|
| qty | integer | |
| product_id* | integer | |
| session_id | string | Only 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 between calls. |
| variant_id | integer |
{
"type": "object",
"required": [
"product_id"
],
"properties": {
"qty": {
"type": "integer",
"default": 1,
"maximum": 99,
"minimum": 1
},
"product_id": {
"type": "integer",
"minimum": 1
},
"session_id": {
"type": "string",
"description": "Only 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 between calls."
},
"variant_id": {
"type": "integer",
"default": 0,
"minimum": 0
}
},
"additionalProperties": false
}Change the quantity of a cart line (the key comes from cart_view). Quantity 0 removes the line.
| Argument | Type | Description |
|---|---|---|
| key* | string | |
| qty* | integer | |
| session_id | string | Only 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 between calls. |
{
"type": "object",
"required": [
"key",
"qty"
],
"properties": {
"key": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"qty": {
"type": "integer",
"maximum": 99,
"minimum": 0
},
"session_id": {
"type": "string",
"description": "Only 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 between calls."
}
},
"additionalProperties": false
}The customer's cart: lines, quantities, prices and totals, as the shop calculates them.
| Argument | Type | Description |
|---|---|---|
| session_id | string | Only 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 between calls. |
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Only 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 between calls."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| qty | integer | |
| product_id* | integer | |
| session_id | string | Only 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 between calls. |
| variant_id | integer |
{
"type": "object",
"required": [
"product_id"
],
"properties": {
"qty": {
"type": "integer",
"default": 1,
"maximum": 999,
"minimum": 1
},
"product_id": {
"type": "integer",
"minimum": 1
},
"session_id": {
"type": "string",
"description": "Only 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 between calls."
},
"variant_id": {
"type": "integer",
"default": 0,
"minimum": 0
}
},
"additionalProperties": false
}The address of the checkout page with the customer's cart, where they review and pay. Payment always happens there.
| Argument | Type | Description |
|---|---|---|
| session_id | string | Only 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 between calls. |
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Only 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 between calls."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| session_id | string | Only 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 between calls. |
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Only 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 between calls."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| buyer_code | string | The 6-digit code the shop emailed to the buyer after checkout_review. Not needed with an API key that has the scope orders:create |
| confirm_token* | string | The confirm_token of the last checkout_review |
| buyer_confirmed* | boolean | true: the person has seen the total and said yes |
{
"type": "object",
"required": [
"confirm_token",
"buyer_confirmed"
],
"properties": {
"buyer_code": {
"type": "string",
"maxLength": 12,
"minLength": 6,
"description": "The 6-digit code the shop emailed to the buyer after checkout_review. Not needed with an API key that has the scope orders:create"
},
"confirm_token": {
"type": "string",
"maxLength": 64,
"minLength": 64,
"description": "The confirm_token of the last checkout_review"
},
"buyer_confirmed": {
"type": "boolean",
"description": "true: the person has seen the total and said yes"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| session_id | string | Only 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 between calls. |
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Only 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 between calls."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| city | string | The city or town only. Only if the customer gave it. |
| note | string | A note for the order, only if the customer asked for one |
| text | string | ONLY 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, text is ignored. |
| string | The email address, nothing else. Only if the customer gave it. | |
| line1 | string | Street 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. |
| line2 | string | Floor, door or staircase only ("3º A", "2n 1a", "bajo"), if given. Only if the customer gave it. |
Choose the payment method (method = the id from checkout_payment_options).
| Argument | Type | Description |
|---|---|---|
| method* | string | |
| session_id | string | Only 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 between calls. |
{
"type": "object",
"required": [
"method"
],
"properties": {
"method": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"session_id": {
"type": "string",
"description": "Only 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 between calls."
}
},
"additionalProperties": false
}Choose the delivery option (carrier_id from checkout_shipping_options).
| Argument | Type | Description |
|---|---|---|
| carrier_id* | integer | |
| session_id | string | Only 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 between calls. |
{
"type": "object",
"required": [
"carrier_id"
],
"properties": {
"carrier_id": {
"type": "integer",
"minimum": 1
},
"session_id": {
"type": "string",
"description": "Only 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 between calls."
}
},
"additionalProperties": false
}The delivery options for the order with their price and delay, and the one selected. Needs the delivery address first.
| Argument | Type | Description |
|---|---|---|
| session_id | string | Only 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 between calls. |
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Only 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 between calls."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| session_id | string | Only 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 between calls. |
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Only 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 between calls."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| session_id | string | Only 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 between calls. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"minimum": 1
},
"session_id": {
"type": "string",
"description": "Only 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 between calls."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| session_id | string | Only 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 between calls. |
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Only 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 between calls."
}
},
"additionalProperties": false
}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).
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | What to look for: the customer's words or, for a vague need, a product type or synonym of your own that fits |
| session_id | string | Only 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 between calls. |
| category_id | integer | Only products of this category (see list_categories) |
| in_stock_only | boolean | |
| max_price_cents | integer | Maximum price in cents: 5000 means 50.00 |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 8,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 120,
"description": "What to look for: the customer's words or, for a vague need, a product type or synonym of your own that fits"
},
"session_id": {
"type": "string",
"description": "Only 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 between calls."
},
"category_id": {
"type": "integer",
"minimum": 1,
"description": "Only products of this category (see list_categories)"
},
"in_stock_only": {
"type": "boolean",
"default": false
},
"max_price_cents": {
"type": "integer",
"maximum": 100000000,
"minimum": 1,
"description": "Maximum price in cents: 5000 means 50.00"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| qty | integer | |
| country | string | ISO 3166-1 alpha-2 code, for example ES |
| postcode | string | |
| product_id | integer | |
| session_id | string | Only 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 between calls. |
| variant_id | integer |
{
"type": "object",
"properties": {
"qty": {
"type": "integer",
"default": 1,
"maximum": 999,
"minimum": 1
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2 code, for example ES"
},
"postcode": {
"type": "string",
"maxLength": 12
},
"product_id": {
"type": "integer",
"minimum": 1
},
"session_id": {
"type": "string",
"description": "Only 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 between calls."
},
"variant_id": {
"type": "integer",
"default": 0,
"minimum": 0
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| topic | string | |
| session_id | string | Only 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 between calls. |
{
"type": "object",
"properties": {
"topic": {
"enum": [
"all",
"about",
"returns",
"shipping",
"terms",
"payment",
"contact",
"hours"
],
"type": "string",
"default": "all"
},
"session_id": {
"type": "string",
"description": "Only 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 between calls."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 17, 2026.
| phone | string | The phone number, digits and an optional + prefix. Only if the customer gave it. |
| region | string | The province or region, only if given. Only if the customer gave it. |
| vat_id | string | The tax or VAT ID exactly as given (keep a country prefix such as "ES"), without the label. Only if the customer gave it. |
| company | string | The 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 name of an office, hotel or association where the parcel is just delivered goes in line2, not here. Send "" to remove a company saved before. Only if the customer gave it. |
| country | string | ISO 3166-1 alpha-2 code ("ES" for Spain). Only if the customer gave it. |
| postcode | string | The postcode only. Only if the customer gave it. |
| last_name | string | The surname or surnames, nothing else. Only if the customer gave it. |
| address_id | integer | One of the saved_addresses ids of checkout_status (customers with an account) |
| first_name | string | The 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 gave it. |
| session_id | string | Only 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 between calls. |
{
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 100,
"description": "The city or town only. Only if the customer gave it."
},
"note": {
"type": "string",
"maxLength": 500,
"description": "A note for the order, only if the customer asked for one"
},
"text": {
"type": "string",
"maxLength": 2000,
"description": "ONLY 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, text is ignored."
},
"email": {
"type": "string",
"maxLength": 191,
"description": "The email address, nothing else. Only if the customer gave it."
},
"line1": {
"type": "string",
"maxLength": 191,
"description": "Street 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."
},
"line2": {
"type": "string",
"maxLength": 191,
"description": "Floor, door or staircase only (\"3º A\", \"2n 1a\", \"bajo\"), if given. Only if the customer gave it."
},
"phone": {
"type": "string",
"maxLength": 40,
"description": "The phone number, digits and an optional + prefix. Only if the customer gave it."
},
"region": {
"type": "string",
"maxLength": 16,
"description": "The province or region, only if given. Only if the customer gave it."
},
"vat_id": {
"type": "string",
"maxLength": 40,
"description": "The tax or VAT ID exactly as given (keep a country prefix such as \"ES\"), without the label. Only if the customer gave it."
},
"company": {
"type": "string",
"maxLength": 160,
"description": "The 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 name of an office, hotel or association where the parcel is just delivered goes in line2, not here. Send \"\" to remove a company saved before. Only if the customer gave it."
},
"country": {
"type": "string",
"maxLength": 2,
"description": "ISO 3166-1 alpha-2 code (\"ES\" for Spain). Only if the customer gave it."
},
"postcode": {
"type": "string",
"maxLength": 16,
"description": "The postcode only. Only if the customer gave it."
},
"last_name": {
"type": "string",
"maxLength": 120,
"description": "The surname or surnames, nothing else. Only if the customer gave it."
},
"address_id": {
"type": "integer",
"minimum": 0,
"description": "One of the saved_addresses ids of checkout_status (customers with an account)"
},
"first_name": {
"type": "string",
"maxLength": 80,
"description": "The 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 gave it."
},
"session_id": {
"type": "string",
"description": "Only 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 between calls."
}
},
"additionalProperties": false
}