English Français العربية

Alshhbaa Copperware — نحاسيات الشهباء

Registre officiel Autres

Luxury chandeliers and lighting catalog MCP server for shop.alshhbaa.com

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http alshhbaa-copperware 'https://shop.alshhbaa.com/.well-known/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "alshhbaa-copperware": {
            "type": "http",
            "url": "https://shop.alshhbaa.com/.well-known/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Alshhbaa Copperware AI Agent Kit 🏺✨
  2. 📦 What's Inside
  3. ⚡ Quickstart
  4. 🛡️ Governance & Human-in-the-Loop (HITL) Guardrails
  5. 🌐 Public Discovery Endpoints
  6. 📄 License

Alshhbaa Copperware AI Agent Kit 🏺✨

The official AI Agent Integration Kit for Alshhbaa Copperware (متجر نحاسيات الشهباء) — a premier Saudi artisan retailer specializing in handcrafted brass chandeliers, Islamic & heritage lighting, wall sconces, luxury table lamps, Bohemian crystal, and Italian glassware.

This repository provides everything autonomous AI agents, coding assistants, and LLMs (Claude, ChatGPT, Cursor, Google Antigravity, OpenClaw, Cline) need to discover, query, validate, and interact with the Alshhbaa Copperware store safely and efficiently.

📦 What's Inside

alshhbaa-agent-kit/
├── README.md                          # Main documentation and integration overview
├── AGENTS.md                          # Detailed instructions & guidelines for AI agents
├── plugin.json                        # Agent Plugins 1.0.0 manifest
├── mcp.json                           # MCP remote streamable HTTP server configuration
├── LICENSE                            # MIT License
├── .gitignore                         # Standard git ignore rules
└── skills/
    └── alshhbaa-store/
        └── SKILL.md                   # Agent skill definition conforming to skills.sh

⚡ Quickstart

1. Using with Model Context Protocol (MCP)

Alshhbaa Copperware provides a remote streamable HTTP MCP server at:

https://shop.alshhbaa.com/.well-known/mcp
In Claude Desktop / Cline / Cursor (claude_desktop_config.json or mcp.json):
{
  "mcpServers": {
    "alshhbaa-store": {
      "type": "streamable-http",
      "url": "https://shop.alshhbaa.com/.well-known/mcp"
    }
  }
}

The server provides:

  • search_products: Fast public catalog search suggestions for chandeliers, lamps, and glassware.
  • read_docs: Access to store developer guides, OpenAPI specifications, and policy documents.
  • UI Resources: Interactive HTML components for developer portals and catalog search surfaces.
2. Using with Agent Plugins & Skills (skills.sh)

Install or load the alshhbaa-store skill directly:

The skill instructs agents how to browse products, check Saudi shipping carrier fees, and validate shopping carts before handoff to checkout.

3. Direct REST API & OpenAPI 3.1

The complete OpenAPI specification is accessible at:

https://shop.alshhbaa.com/openapi.json

Key REST API endpoints:

EndpointMethodDescriptionAuth
/api/v1/productsGETCursor-paginated catalog listing with filtersNone (Public)
/api/v1/search/suggestionsGETFast suggestions search by query ?q=None (Public)
/api/v1/citiesGETSearch supported Saudi cities for shippingNone (Public)
/api/v1/shipping-carriersGETLive shipping quotes based on city & itemsNone (Public)
/api/v1/cart/syncPOSTServer-side cart validation and stock checkingNone (Idempotency-Key)
/api/v1/orders/{id}/statusGETOrder fulfillment status & shipment trackingCustomer Token
/api/v1/orders/{id}/invoice/jobsPOSTAsynchronous PDF invoice generationCustomer Token

🛡️ Governance & Human-in-the-Loop (HITL) Guardrails

Alshhbaa Copperware enforces strict agent permissions as defined in /.well-known/agent-permissions.json:

  1. Human-in-the-Loop Checkout: AI agents are allowed to search, browse, estimate shipping, and sync carts. However, checkout and payment require explicit human confirmation. Agents must never finalize payment autonomously.
  2. Payment Security: Agents must never capture, store, or transmit credit card details or CVVs. All transactions are securely completed on https://shop.alshhbaa.com/checkout.
  3. No Hallucinations: Product prices, availability, and delivery fees must be fetched from the API.
  4. Data Privacy: Order tokens and customer information must remain private. Administrative endpoints (/admin) are strictly forbidden.

For full rules and agent instructions, see AGENTS.md.

🌐 Public Discovery Endpoints

📄 License

This repository is licensed under the MIT License. Copyright (c) 2026 Alshhbaa Copperware (متجر نحاسيات الشهباء).

Questions fréquentes

Qu'est-ce que Alshhbaa Copperware — نحاسيات الشهباء ?

Luxury chandeliers and lighting catalog MCP server for shop.alshhbaa.com

Comment installer Alshhbaa Copperware — نحاسيات الشهباء ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http alshhbaa-copperware 'https://shop.alshhbaa.com/.well-known/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Alshhbaa Copperware — نحاسيات الشهباء ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Alshhbaa Copperware — نحاسيات الشهباء est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Alshhbaa Copperware — نحاسيات الشهباء ?

Il est publié par Alshhbaa. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.