Kapruka

Présentation

Se connecte à Kapruka.com, une plateforme de e-commerce sri-lankaise. Vous pouvez rechercher dans le catalogue, parcourir les catégories, lire les détails des produits, vérifier la disponibilité et les frais de livraison par ville et par date, créer des commandes sans compte qui renvoient un lien de paiement, et suivre les commandes existantes.

Fonctionne comme un endpoint Streamable HTTP hébergé sur mcp.kapruka.com. L’offre publique gratuite ne nécessite ni compte ni clé API et est limitée à 60 requêtes par minute par IP cliente. Les résultats peuvent être mis en cache jusqu’à 30 minutes.

Ce que vous pouvez faire

• Rechercher des produits par mot-clé avec facettes de catégorie
• Obtenir les détails, les prix et les variantes d’un produit
• Vérifier la disponibilité, la date et les frais de livraison par ville
• Créer des commandes sans compte avec un lien de paiement
• Suivre les commandes par numéro de commande
• Afficher des options de produits sous forme de carte image partageable
• Lister les catégories principales et les villes de livraison

Outils 10

• kapruka_list_categoriesLecture seule

  Lister les catégories de navigation principales avec les URL de navigation Kapruka.com.

• kapruka_get_productLecture seule

  Obtenir tous les détails d’un produit : prix, stock, variantes, images et zone de livraison.

• kapruka_search_productsLecture seule

  Rechercher des produits par mot-clé avec filtre de catégorie et résultats paginés.

• kapruka_create_orderÉcriture

  Créer une commande sans compte et renvoyer un lien de paiement en un clic.

• kapruka_track_orderLecture seule

  Consulter l’état d’une commande et l’avancement de la livraison par numéro de commande.

• kapruka_render_options_cardLecture seule

  Afficher 1 à 4 produits sous forme d’une carte menu JPEG partageable avec références numérotées.

• kapruka_list_delivery_citiesLecture seule

  Lister ou rechercher les villes du Sri Lanka où Kapruka livre.

• kapruka_check_deliveryLecture seule

  Vérifier la disponibilité de la livraison pour une ville et une date, ainsi que les frais de livraison.

• kapruka_gift_countriesLecture seule

  Kapruka International Gifts — Countries

• kapruka_gift_country_productsLecture seule

  Kapruka International Gifts — Store

Lus directement sur le serveur le 26 oct. 2026. Lecture seule, Écriture et Peut supprimer sont des indications déclarées par le serveur ; c’est votre client qui décide de vous demander confirmation avant d’exécuter un outil.

Exemples de prompts

• Trouve des gâteaux d’anniversaire sur Kapruka à moins de 5000 LKR

• Ce produit peut-il être livré à Kandy vendredi prochain ?

• Crée une commande pour ces deux cadeaux à Colombo et donne-moi le lien de paiement

• Suis ma commande Kapruka numéro 123456

Configuration

Chaque client se connecte à mcp.kapruka.com. Choisissez le vôtre ; la page retient votre choix.

claude mcp add --transport http kapruka https://mcp.kapruka.com/mcp

https://mcp.kapruka.com/mcp

{
  "mcpServers": {
    "kapruka": {
      "url": "https://mcp.kapruka.com/mcp"
    }
  }
}

code --add-mcp '{"name":"kapruka","type":"http","url":"https://mcp.kapruka.com/mcp"}'

{
  "servers": {
    "kapruka": {
      "type": "http",
      "url": "https://mcp.kapruka.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "kapruka": {
      "serverUrl": "https://mcp.kapruka.com/mcp"
    }
  }
}

codex mcp add kapruka --url https://mcp.kapruka.com/mcp

[mcp_servers.kapruka]
url = "https://mcp.kapruka.com/mcp"

gemini mcp add --transport http kapruka https://mcp.kapruka.com/mcp

{
  "mcpServers": {
    "kapruka": {
      "type": "http",
      "url": "https://mcp.kapruka.com/mcp"
    }
  }
}

Intégrer

Affichez Kapruka dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise l’URL du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations

La carte, l’iframe et le JSON sont en anglais. Ajoutez ?lang=it, fr, de ou es à leur adresse pour une autre langue.

Badge pour README Carte pour site web iframe JSON Prompt pour l’IA

Badge pour README

Markdown

[![Kapruka on mcp.tc](https://mcp.tc/i/kapruka/badge.svg)](https://mcp.tc/i/kapruka)

HTML

<a href="https://mcp.tc/i/kapruka"><img src="https://mcp.tc/i/kapruka/badge.svg" alt="Kapruka on mcp.tc" height="20"></a>

Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.

Carte pour site web

HTML

<script src="https://mcp.tc/w/kapruka.js" async></script>

La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun cookie.

iframe

HTML

<iframe src="https://mcp.tc/embed/kapruka" title="Kapruka on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.

JSON

La fiche sous forme de données pour vos pages et vos outils : nom, accroche, URL du serveur, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).

https://mcp.tc/i/kapruka.json

Ce que signifie chaque champ

Prompt pour l’IA

Collez-le dans un assistant de code IA, comme Claude Code ou Cursor, et il ajoutera la carte de Kapruka à votre site.

Markdown

Ajoute à mon site la carte mcp.tc de Kapruka, un serveur MCP. C’est un seul script statique : pas de build, aucun paquet à installer, aucun cookie.

Place cette balise là où la carte doit apparaître. La carte s’affiche juste avant elle :

```html
<script src="https://mcp.tc/w/kapruka.js" async></script>
```

Pour l’afficher ailleurs, mets ce conteneur à cet endroit et charge le même script une seule fois, par exemple avant `</body>`. Garde le lien à l’intérieur : les visiteurs sans JavaScript le voient.

```html
<div data-mcptc="kapruka"><a href="https://mcp.tc/i/kapruka">Kapruka on mcp.tc</a></div>
```

Options :
- `data-theme="light"` ou `"dark"` sur la balise ou le conteneur fixe les couleurs. Sans cela, la carte suit le mode clair ou sombre du visiteur.
- `data-size="compact"` donne une carte plus petite, sans l’accroche.
- La variable CSS `--mcptc-max-width` sur le conteneur ou un parent fixe la largeur (`520px` par défaut).
- `?lang=` dans l’URL du script choisit la langue de la carte : `en`, `it`, `fr`, `de` ou `es`.

Si le site a une Content Security Policy, autorise `script-src https://mcp.tc` et `img-src data:` (l’icône est intégrée).

Pour un README ou une autre doc en Markdown, utilise plutôt le badge :

```markdown
[![Kapruka on mcp.tc](https://mcp.tc/i/kapruka/badge.svg)](https://mcp.tc/i/kapruka)
```

Référence : https://mcp.tc/fr/embed

Historique des changements

Nous lisons la liste d’outils de ce serveur toutes les 3 heures et notons ce qui change. Dernière lecture : 26 oct. 2026, 17:40 UTC.

1. 20 oct. 2026, 07:39 UTC, Vérification automatique

   2 outils ajoutés et 4 outils modifiés. Instructions du serveur modifiées.

   Nouvelles instructions du serveur

   Détails, 20 oct. 2026, 07:39 UTC

   Ajoutés 2

   • kapruka_gift_countriesLecture seule

     List the countries Kapruka delivers gifts IN (international gift stores). Use when the RECIPIENT is outside Sri Lanka — e.g. "send flowers to my sister in Dubai", "a cake for my son in Melbourne". These gifts are delivered by Kapruka's partner in that country, not shipped from Sri Lanka. They are NOT in kapruka_search_products; list a store with kapruka_gift_country_products. For each country: how many gifts are in stock now (0 = nothing can be ordered there right now — say so), the delivery fee (one fee per order, whatever the number of items), and for Australia and the UAE the zones they deliver to — delivery is ONLY to those zones, each with its own fee. The earliest delivery date is 3 days from today (Sri Lanka date). Args: params: currency ('LKR' default or 'USD'), response_format. Returns: str. JSON: {"currency", "earliest_date", "countries": [{"country", "products_in_stock", "delivery_fee": {"amount","currency"}, "zone_required": bool, "zones": [{"name","delivery_fee"}], "earli…

   • kapruka_gift_country_productsLecture seule

     List EVERY gift in stock in one country's store (international gifts), grouped by type. The stores are small (tens of products), so this returns the whole store: read it and choose for the customer — there is no keyword search for these products. Prices are exactly what checkout charges for the item (no website discounts apply to these stores); delivery is extra — one fee per order (zone fee in Australia / the UAE), shown at the top. Use the `id` with kapruka_get_product for full detail and with kapruka_create_order (delivery.type "international_gift"). Args: params: country, type (optional filter), currency ('LKR' default or 'USD'), response_format. Returns: str. JSON: {"country", "currency", "count", "delivery": {country row from kapruka_gift_countries}, "products": [{"id", "name", "type", "summary", "price": {"amount","currency"}, "image_url", "url"}]}

   Modifiés 4

   • kapruka_check_deliverydescription et schéma d’entrée

     Le texte affiché ici est identique avant et après : le changement se situe au-delà des 1 000 premiers caractères ou dans des caractères qui ne s’affichent pas.

   • kapruka_create_orderschéma d’entrée
   • kapruka_get_productdescription
     Avant

     Fetch full details for a single Kapruka product by its product ID. Returns name, description, price (with optional currency conversion), stock status, images, variants, shipping info, delivery scope, and a direct product URL. `economy_delivery` ("optional" | "only" | "only_5to7" | null) says whether the item can go by the cheaper economy courier; kapruka_check_delivery with the cart says whether an order is offered it. Discounts: `price` is what checkout charges, with any website discount already applied; `compare_at_price` is the pre-discount price when one applies (null otherwise). Each variant carries its own pair. Quote `price`. Delivery scope: most gifts ship island-wide, but restaurant food, hotel cakes and liquor only reach a limited city set (typically the Colombo area). The `delivery` object is the authority — search results do NOT carry it. When `delivery.island_wide` is false, tell the customer up front that the item is delivered only to selected cities, and confirm their c…

     Après

     Fetch full details for a single Kapruka product by its product ID. Returns name, description, price (with optional currency conversion), stock status, images, variants, shipping info, delivery scope, and a direct product URL. `economy_delivery` ("optional" | "only" | "only_5to7" | null) says whether the item can go by the cheaper economy courier; kapruka_check_delivery with the cart says whether an order is offered it. International gift store products carry `international_gift` {"country", "orderable", "store_url"}: they are delivered IN that country by Kapruka's partner (see kapruka_gift_countries), not in Sri Lanka. Discounts: `price` is what checkout charges, with any website discount already applied; `compare_at_price` is the pre-discount price when one applies (null otherwise). Each variant carries its own pair. Quote `price`. Delivery scope: most gifts ship island-wide, but restaurant food, hotel cakes and liquor only reach a limited city set (typically the Colombo area). The `…

   • kapruka_search_productsdescription

     Le texte affiché ici est identique avant et après : le changement se situe au-delà des 1 000 premiers caractères ou dans des caractères qui ne s’affichent pas.

   Instructions du serveur

   Avant

   You are connected to the Kapruka MCP server for Kapruka.com — Sri Lanka's largest e-commerce platform. Use the tools to search products, browse categories, look up product details, quote delivery, create guest-checkout orders (pay link) and track orders. This is a free public tier; treat results as cached for up to 30 minutes. DELIVERY-CITY LIMITS — follow these rules: 1. Most gifts ship island-wide, but restaurant food, hotel cakes and liquor are delivered only to selected cities (typically the Colombo area). Never promise delivery of a product to a city without checking: call kapruka_check_delivery with BOTH city and product_id (or read delivery.island_wide from kapruka_get_product). Say yes only if available is true. 2. Surface the limit proactively: when a product's delivery.island_wide is false, tell the customer it is delivered only to selected cities before they pick a city. If deliverable_city_count is larger than the list you were given, say 'and more' — the list is truncated. 3. On item_deliverable=false / available=false, offer the returned deliverable_cities (nearest first) or an island-wide alternative. Do not retry kapruka_create_order with the same city. 4. An order ships as ONE shipment, so the whole cart must be deliverable to the city (intersection of every item's cities). If kapruka_create_order returns city_not_deliverable_for_item, nothing was created: tell the customer which item blocks it and offer to change the city or remove/replace that item. Never pretend a partial order was placed. 5. Search results carry no delivery info — resolve it per item via kapruka_get_product or kapruka_check_delivery. 6. Send canonical city spellings from kapruka_list_delivery_cities / deliverable_cities.

   Après

   You are connected to the Kapruka MCP server for Kapruka.com — Sri Lanka's largest e-commerce platform. Use the tools to search products, browse categories, look up product details, quote delivery, create guest-checkout orders (pay link) and track orders. This is a free public tier; treat results as cached for up to 30 minutes. DELIVERY-CITY LIMITS — follow these rules: 1. Most gifts ship island-wide, but restaurant food, hotel cakes and liquor are delivered only to selected cities (typically the Colombo area). Never promise delivery of a product to a city without checking: call kapruka_check_delivery with BOTH city and product_id (or read delivery.island_wide from kapruka_get_product). Say yes only if available is true. 2. Surface the limit proactively: when a product's delivery.island_wide is false, tell the customer it is delivered only to selected cities before they pick a city. If deliverable_city_count is larger than the list you were given, say 'and more' — the list is truncated. 3. On item_deliverable=false / available=false, offer the returned deliverable_cities (nearest first) or an island-wide alternative. Do not retry kapruka_create_order with the same city. 4. An order ships as ONE shipment, so the whole cart must be deliverable to the city (intersection of every item's cities). If kapruka_create_order returns city_not_deliverable_for_item, nothing was created: tell the customer which item blocks it and offer to change the city or remove/replace that item. Never pretend a partial order was placed. 5. Search results carry no delivery info — resolve it per item via kapruka_get_product or kapruka_check_delivery. 6. Send canonical city spellings from kapruka_list_delivery_cities / deliverable_cities. INTERNATIONAL GIFTS — when the RECIPIENT is outside Sri Lanka (USA, UK, Canada, Australia, UAE, ...): call kapruka_gift_countries, then kapruka_gift_country_products(country) and choose from the whole store (these products are not in kapruka_search_products).…

2. 12 oct. 2026, 13:33 UTC, Vérification automatique

   3 outils modifiés.

   Détails, 12 oct. 2026, 13:33 UTC

   Modifiés 3

   • kapruka_check_deliverydescription et schéma d’entrée

     Le texte affiché ici est identique avant et après : le changement se situe au-delà des 1 000 premiers caractères ou dans des caractères qui ne s’affichent pas.

   • kapruka_create_orderdescription et schéma d’entrée

     Le texte affiché ici est identique avant et après : le changement se situe au-delà des 1 000 premiers caractères ou dans des caractères qui ne s’affichent pas.

   • kapruka_get_productdescription
     Avant

     Fetch full details for a single Kapruka product by its product ID. Returns name, description, price (with optional currency conversion), stock status, images, variants, shipping info, delivery scope, and a direct product URL. Discounts: `price` is what checkout charges, with any website discount already applied; `compare_at_price` is the pre-discount price when one applies (null otherwise). Each variant carries its own pair. Quote `price`. Delivery scope: most gifts ship island-wide, but restaurant food, hotel cakes and liquor only reach a limited city set (typically the Colombo area). The `delivery` object is the authority — search results do NOT carry it. When `delivery.island_wide` is false, tell the customer up front that the item is delivered only to selected cities, and confirm their city with kapruka_check_delivery(city, product_id) before promising anything. If `deliverable_city_count` exceeds the returned list, the list is truncated — say "and more", don't treat it as complet…

     Après

     Fetch full details for a single Kapruka product by its product ID. Returns name, description, price (with optional currency conversion), stock status, images, variants, shipping info, delivery scope, and a direct product URL. `economy_delivery` ("optional" | "only" | "only_5to7" | null) says whether the item can go by the cheaper economy courier; kapruka_check_delivery with the cart says whether an order is offered it. Discounts: `price` is what checkout charges, with any website discount already applied; `compare_at_price` is the pre-discount price when one applies (null otherwise). Each variant carries its own pair. Quote `price`. Delivery scope: most gifts ship island-wide, but restaurant food, hotel cakes and liquor only reach a limited city set (typically the Colombo area). The `delivery` object is the authority — search results do NOT carry it. When `delivery.island_wide` is false, tell the customer up front that the item is delivered only to selected cities, and confirm their c…

3. 9 oct. 2026, 04:21 UTC, Vérification automatique

   Début de l’observation : 8 outils.

FAQ