Maison Éclaire MCP
A read-only MCP server for the Maison Éclaire Moroccan handmade candle shop. It allows AI agents to search products, retrieve product details, list categories, get shop information, and find gift ideas without requiring authentication.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://www.maisoneclaire.co/mcpWhat you can do with it
- Search for handmade candles and supplies
- Retrieve specific product details and prices
- List available product categories
- Get curated gift ideas for occasions
Source and maintenance
Protocol and capabilities
- Server
- Maison Éclaire 1.0.0
- MCP protocol
- 2025-06-18
- Tools
- 5 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
5 advertised
search_products — Search Maison Éclaire products
Search Maison Éclaire's catalogue of handmade candles, gift packs, flower boxes, candle holders, snow globes, table decor, wedding favours and candle-making supplies (wax, wicks, fragrance oils, dyes, moulds, kits) sold online with delivery across Morocco. Use when the user is looking for candles, a candle gift, or candle-making supplies in Morocco. Always use image_url (or the Image: lines) from this tool for product photos; never use other images.
{
"type": "object",
"required": [
"query"
],
"properties": {
"lang": {
"enum": [
"fr",
"en",
"ar"
],
"type": "string",
"default": "fr",
"description": "Language of names, descriptions, labels and URLs: fr (default), en or ar"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "What the user is looking for, in any language (\"bougie parfumée\", \"soy wax\", \"شمع\"). A budget in it (\"moins de 150 dh\", \"under 150 MAD\") caps the price unless max_price is given"
},
"category": {
"enum": [
"bougies",
"packs",
"flower-box",
"decoration-de-table",
"cadeaux",
"cadeaux-mariage",
"cadeaux-pour-elle",
"cadeaux-ramadan",
"fournitures",
"cire-bougie",
"meches",
"huiles-aromatiques",
"colorants",
"moules",
"bougeoirs",
"boule-de-neige",
"kits"
],
"type": "string",
"description": "Only this category (ids from list_categories)"
},
"max_price": {
"type": "number",
"maximum": 100000,
"minimum": 1,
"description": "Maximum price in MAD; sold-out products are left out"
},
"in_stock_only": {
"type": "boolean",
"default": false,
"description": "Leave out sold-out products"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"products",
"total",
"search_url"
],
"properties": {
"total": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"products": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name",
"short_description",
"category",
"in_stock",
"image_url",
"url"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"category": {
"type": "object",
"required": [
"id",
"label",
"url"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"label": {
"type": "string"
}
},
"additionalProperties": false
},
"in_stock": {
"type": "boolean"
},
"image_url": {
"type": [
"string",
"null"
]
},
"price_mad": {
"type": "number"
},
"old_price_mad": {
"type": "number"
},
"price_is_from": {
"type": "boolean"
},
"short_description": {
"type": "string"
}
},
"additionalProperties": false
}
},
"search_url": {
"type": "string"
},
"applied_max_price": {
"type": "number",
"description": "Maximum price in MAD applied to the results: max_price, or a budget written in the query"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_product — Get a Maison Éclaire product
Full details of one Maison Éclaire product by its slug (from search_products or a /produit/<slug> URL): localized name and description, price and variant prices when in stock, photos and product URL. Always use image_url (or the Image: lines) from this tool for product photos; never use other images.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"lang": {
"enum": [
"fr",
"en",
"ar"
],
"type": "string",
"default": "fr",
"description": "Language of names, descriptions, labels and URLs: fr (default), en or ar"
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9-]{1,120}$",
"description": "The product slug, as in its URL /produit/<slug>"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"slug",
"name",
"short_description",
"category",
"in_stock",
"image_url",
"url",
"description"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"category": {
"type": "object",
"required": [
"id",
"label",
"url"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"label": {
"type": "string"
}
},
"additionalProperties": false
},
"in_stock": {
"type": "boolean"
},
"variants": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"price_mad"
],
"properties": {
"label": {
"type": "string"
},
"price_mad": {
"type": "number"
}
},
"additionalProperties": false
}
},
"image_url": {
"type": [
"string",
"null"
]
},
"price_mad": {
"type": "number"
},
"description": {
"type": "string"
},
"old_price_mad": {
"type": "number"
},
"price_is_from": {
"type": "boolean"
},
"gallery_images": {
"type": "array",
"items": {
"type": "string"
}
},
"short_description": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_categories — List Maison Éclaire categories
The categories of the Maison Éclaire shop (candles, packs, flower boxes, gifts, weddings, table decor, candle-making supplies) with their URLs and the number of published products, plus the gift card and build-your-box pages.
{
"type": "object",
"properties": {
"lang": {
"enum": [
"fr",
"en",
"ar"
],
"type": "string",
"default": "fr",
"description": "Language of names, descriptions, labels and URLs: fr (default), en or ar"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"categories",
"links"
],
"properties": {
"links": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"label",
"url"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"label": {
"type": "string"
}
},
"additionalProperties": false
}
},
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"label",
"url",
"group",
"product_count"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"group": {
"enum": [
"candles_gifts",
"supplies"
],
"type": "string"
},
"label": {
"type": "string"
},
"product_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_shop_info — Maison Éclaire delivery, payment and returns
Delivery fees and times across Morocco, free-delivery threshold, minimum order, cash-on-delivery payment, returns policy and WhatsApp contact for Maison Éclaire. Use before telling a user how ordering, delivery or returns work.
{
"type": "object",
"properties": {
"lang": {
"enum": [
"fr",
"en",
"ar"
],
"type": "string",
"default": "fr",
"description": "Language of names, descriptions, labels and URLs: fr (default), en or ar"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"name",
"city",
"currency",
"summary",
"delivery",
"minimum_order_mad",
"minimum_order_note",
"payment",
"returns",
"contact",
"links",
"source_urls"
],
"properties": {
"city": {
"type": "string"
},
"name": {
"type": "string"
},
"links": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"label",
"url"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"label": {
"type": "string"
}
},
"additionalProperties": false
}
},
"contact": {
"type": "object",
"required": [
"phone",
"whatsapp",
"contact_url"
],
"properties": {
"phone": {
"type": "string"
},
"whatsapp": {
"type": "string"
},
"contact_url": {
"type": "string"
}
},
"additionalProperties": false
},
"payment": {
"type": "object",
"required": [
"methods",
"note"
],
"properties": {
"note": {
"type": "string"
},
"methods": {
"type": "array",
"items": {
"type": "string",
"const": "cash_on_delivery"
}
}
},
"additionalProperties": false
},
"returns": {
"type": "object",
"required": [
"window_days",
"conditions"
],
"properties": {
"conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"window_days": {
"type": "number"
},
"refund_within_days": {
"type": "number"
},
"damaged_item_report_hours": {
"type": "number"
}
},
"additionalProperties": false
},
"summary": {
"type": "string"
},
"currency": {
"type": "string",
"const": "MAD"
},
"delivery": {
"type": "object",
"required": [
"coverage",
"delay_days",
"zones",
"exact_fee_note",
"free_delivery_threshold_mad",
"free_delivery_note",
"how_it_works"
],
"properties": {
"zones": {
"type": "array",
"items": {
"type": "object",
"required": [
"fee_mad",
"city_examples",
"other_cities",
"all_other_cities",
"cities_label"
],
"properties": {
"fee_mad": {
"type": "number"
},
"cities_label": {
"type": "string"
},
"other_cities": {
"type": "boolean"
},
"city_examples": {
"type": "array",
"items": {
"type": "string"
}
},
"all_other_cities": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"coverage": {
"type": "string",
"const": "all_of_morocco"
},
"delay_days": {
"type": "object",
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"additionalProperties": false
},
"how_it_works": {
"type": "array",
"items": {
"type": "string"
}
},
"exact_fee_note": {
"type": "string"
},
"free_delivery_note": {
"type": "string"
},
"free_delivery_threshold_mad": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"source_urls": {
"type": "array",
"items": {
"type": "string"
}
},
"minimum_order_mad": {
"type": "number"
},
"minimum_order_note": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_gift_ideas — Maison Éclaire gift ideas
Gift ideas from Maison Éclaire (handmade candles, gift packs, flower boxes, candle holders, wedding favours) within a budget in MAD, for occasions like Valentine's Day, Ramadan, Eid, weddings or birthdays, delivered across Morocco. Always use image_url (or the Image: lines) from this tool for product photos; never use other images.
{
"type": "object",
"required": [
"budget"
],
"properties": {
"lang": {
"enum": [
"fr",
"en",
"ar"
],
"type": "string",
"default": "fr",
"description": "Language of names, descriptions, labels and URLs: fr (default), en or ar"
},
"limit": {
"type": "integer",
"default": 6,
"maximum": 12,
"minimum": 1
},
"budget": {
"type": "number",
"maximum": 100000,
"minimum": 30,
"description": "Budget in MAD"
},
"occasion": {
"enum": [
"any",
"valentine",
"birthday",
"thank_you",
"for_her",
"wedding",
"wedding_guests",
"ramadan",
"eid",
"christmas"
],
"type": "string",
"default": "any"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ideas",
"gift_card_url",
"guide_url",
"note"
],
"properties": {
"note": {
"type": "string"
},
"ideas": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name",
"short_description",
"category",
"in_stock",
"image_url",
"url"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"category": {
"type": "object",
"required": [
"id",
"label",
"url"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"label": {
"type": "string"
}
},
"additionalProperties": false
},
"in_stock": {
"type": "boolean"
},
"image_url": {
"type": [
"string",
"null"
]
},
"price_mad": {
"type": "number"
},
"old_price_mad": {
"type": "number"
},
"price_is_from": {
"type": "boolean"
},
"short_description": {
"type": "string"
}
},
"additionalProperties": false
}
},
"guide_url": {
"type": "string"
},
"gift_card_url": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 931 ms
- 95th percentile latency
- 931 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 931 ms · metadata changed · 5 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http maison-e-claire-mcp https://www.maisoneclaire.co/mcpCodex
codex mcp add maison-e-claire-mcp --url https://www.maisoneclaire.co/mcpCursor
{
"mcpServers": {
"maison-e-claire-mcp": {
"url": "https://www.maisoneclaire.co/mcp"
}
}
}Cline
{
"mcpServers": {
"maison-e-claire-mcp": {
"type": "streamableHttp",
"url": "https://www.maisoneclaire.co/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"maison-e-claire-mcp": {
"type": "http",
"url": "https://www.maisoneclaire.co/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http maison-e-claire-mcp https://www.maisoneclaire.co/mcpClaude Desktop
{
"mcpServers": {
"maison-e-claire-mcp": {
"url": "https://www.maisoneclaire.co/mcp"
}
}
}Windsurf
{
"mcpServers": {
"maison-e-claire-mcp": {
"serverUrl": "https://www.maisoneclaire.co/mcp"
}
}
}Let your agent find its tools
Find servers like Maison Éclaire MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run Maison Éclaire MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.