Server definition
- Hash
- sha256:7533358ee86eac2f49d361df0a020481267557d8143435c56a1a90fbdd0e73be
- What it is
- What a remote MCP server returned when asked what it offers: 18 tools
The blob, as servednamed by its sha256
{
"instructions": "This is the online shop AIFEC. Use search_products and get_product to find things, then cart_add to build a cart (it belongs to this session). To buy: checkout_set_customer, checkout_shipping_options and checkout_set_shipping, checkout_payment_options and checkout_set_payment, then checkout_review. Show the person the total from the review and wait for a clear yes before calling checkout_place with the confirm_token and buyer_confirmed true. For security the shop emails a 6-digit verification code to the buyer when you review: tell the person, ask for it, wait, and send it as buyer_code (an API key with the scope orders:create does not need it). When the person describes a need instead of a product, show them two or three products of this shop that fit (name and price), when there are, and call cart_add only for the one they choose. The delivery needs a phone: the carrier asks for it. Prices always come from the shop: never calculate them. The person pays; checkout_link gives an address where they can pay on the web instead.",
"tools": [
{
"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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"product_id": {
"description": "The id of the product, from search_products",
"minimum": 1,
"type": "integer"
},
"qty": {
"default": 1,
"description": "How many units to add",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"session_id": {
"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.",
"type": "string"
},
"variant_id": {
"default": 0,
"description": "The id of the variant (colour, size…), from get_product; 0 for a product without variants",
"minimum": 0,
"type": "integer"
}
},
"required": [
"product_id"
],
"type": "object"
},
"name": "cart_add",
"outputSchema": null
},
{
"description": "Change the quantity of a cart line (the key comes from cart_view). Quantity 0 removes the line.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"key": {
"description": "The key of the cart line, from cart_view",
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"qty": {
"description": "The new number of units; 0 removes the line",
"maximum": 99,
"minimum": 0,
"type": "integer"
},
"session_id": {
"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.",
"type": "string"
}
},
"required": [
"key",
"qty"
],
"type": "object"
},
"name": "cart_update",
"outputSchema": null
},
{
"description": "The customer's cart: lines, quantities, prices and totals, as the shop calculates them.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"session_id": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "cart_view",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"product_id": {
"description": "The id of the product, from search_products",
"minimum": 1,
"type": "integer"
},
"qty": {
"default": 1,
"description": "How many units",
"maximum": 999,
"minimum": 1,
"type": "integer"
},
"session_id": {
"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.",
"type": "string"
},
"variant_id": {
"default": 0,
"description": "The id of the variant (colour, size…), from get_product; 0 for a product without variants",
"minimum": 0,
"type": "integer"
}
},
"required": [
"product_id"
],
"type": "object"
},
"name": "check_availability",
"outputSchema": null
},
{
"description": "The address of the checkout page with the customer's cart, where they review and pay. Payment always happens there.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"session_id": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "checkout_link",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"session_id": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "checkout_payment_options",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"buyer_code": {
"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",
"maxLength": 12,
"minLength": 6,
"type": "string"
},
"buyer_confirmed": {
"description": "true: the person has seen the total and said yes",
"type": "boolean"
},
"confirm_token": {
"description": "The confirm_token of the last checkout_review",
"maxLength": 64,
"minLength": 64,
"type": "string"
}
},
"required": [
"confirm_token",
"buyer_confirmed"
],
"type": "object"
},
"name": "checkout_place",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"session_id": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "checkout_review",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"address_id": {
"description": "One of the saved_addresses ids of checkout_status (customers with an account)",
"minimum": 0,
"type": "integer"
},
"city": {
"description": "The city or town only. Only if the customer gave it.",
"maxLength": 100,
"type": "string"
},
"company": {
"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.",
"maxLength": 160,
"type": "string"
},
"country": {
"description": "ISO 3166-1 alpha-2 code (\"ES\" for Spain). Only if the customer gave it.",
"maxLength": 2,
"type": "string"
},
"email": {
"description": "The email address, nothing else. Only if the customer gave it.",
"maxLength": 191,
"type": "string"
},
"first_name": {
"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.",
"maxLength": 80,
"type": "string"
},
"last_name": {
"description": "The surname or surnames, nothing else. Only if the customer gave it.",
"maxLength": 120,
"type": "string"
},
"line1": {
"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.",
"maxLength": 191,
"type": "string"
},
"line2": {
"description": "Floor, door or staircase only (\"3º A\", \"2n 1a\", \"bajo\"), if given. Only if the customer gave it.",
"maxLength": 191,
"type": "string"
},
"note": {
"description": "A note for the order, only if the customer asked for one",
"maxLength": 500,
"type": "string"
},
"phone": {
"description": "The phone number, digits and an optional + prefix. Only if the customer gave it.",
"maxLength": 40,
"type": "string"
},
"postcode": {
"description": "The postcode only. Only if the customer gave it.",
"maxLength": 16,
"type": "string"
},
"region": {
"description": "The province or region, only if given. Only if the customer gave it.",
"maxLength": 16,
"type": "string"
},
"session_id": {
"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.",
"type": "string"
},
"text": {
"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.",
"maxLength": 2000,
"type": "string"
},
"vat_id": {
"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.",
"maxLength": 40,
"type": "string"
}
},
"type": "object"
},
"name": "checkout_set_customer",
"outputSchema": null
},
{
"description": "Choose the payment method (method = the id from checkout_payment_options).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"method": {
"description": "The id of the payment method, from checkout_payment_options",
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"session_id": {
"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.",
"type": "string"
}
},
"required": [
"method"
],
"type": "object"
},
"name": "checkout_set_payment",
"outputSchema": null
},
{
"description": "Choose the delivery option (carrier_id from checkout_shipping_options).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"carrier_id": {
"description": "The id of the delivery option, from checkout_shipping_options",
"minimum": 1,
"type": "integer"
},
"session_id": {
"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.",
"type": "string"
}
},
"required": [
"carrier_id"
],
"type": "object"
},
"name": "checkout_set_shipping",
"outputSchema": null
},
{
"description": "The delivery options for the order with their price and delay, and the one selected. Needs the delivery address first.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"session_id": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "checkout_shipping_options",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"session_id": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "checkout_status",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "The id of the product, from search_products",
"minimum": 1,
"type": "integer"
},
"session_id": {
"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.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_product",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"session_id": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "list_categories",
"outputSchema": null
},
{
"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).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"category_id": {
"description": "Only products of this category (see list_categories)",
"minimum": 1,
"type": "integer"
},
"in_stock_only": {
"default": false,
"description": "true: only products that can be bought now",
"type": "boolean"
},
"limit": {
"default": 5,
"description": "How many products to return, from 1 to 8",
"maximum": 8,
"minimum": 1,
"type": "integer"
},
"max_price_cents": {
"description": "Maximum price in cents: 5000 means 50.00",
"maximum": 100000000,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "What to look for: the customer's words or, for a vague need, a product type or synonym of your own that fits",
"maxLength": 120,
"type": "string"
},
"session_id": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "search_products",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"country": {
"description": "ISO 3166-1 alpha-2 code, for example ES",
"maxLength": 2,
"minLength": 2,
"type": "string"
},
"postcode": {
"description": "The postcode of the delivery address",
"maxLength": 12,
"type": "string"
},
"product_id": {
"description": "The id of the product, from search_products",
"minimum": 1,
"type": "integer"
},
"qty": {
"default": 1,
"description": "How many units",
"maximum": 999,
"minimum": 1,
"type": "integer"
},
"session_id": {
"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.",
"type": "string"
},
"variant_id": {
"default": 0,
"description": "The id of the variant (colour, size…), from get_product; 0 for a product without variants",
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "shipping_quote",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"session_id": {
"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.",
"type": "string"
},
"topic": {
"default": "all",
"description": "What to tell about the shop; all gives everything",
"enum": [
"all",
"about",
"returns",
"shipping",
"terms",
"payment",
"contact",
"hours"
],
"type": "string"
}
},
"type": "object"
},
"name": "store_info",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:7533358ee86eac2f49d361df0a020481267557d8143435c56a1a90fbdd0e73be | sha256sum