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

io.github.AlshhbaaPublished by GitHub account Alshhbaav1.0.1Updated Nov 1, 2026

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

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for the Alshhbaa Copperware lighting store that lets an assistant search the public product catalog and read the store's developer…

What you can do
  • Search public product suggestions for chandeliers, lamps and glassware without touching cart or checkout.
  • Read the store's developer documentation, including API, auth, pricing, OpenAPI, llms.txt and agent-skill material.
When to use it
Useful when an assistant needs to look up products from this Saudi artisan lighting retailer or consult its public API and agent documentation, for example while helping a user browse or plan a purchase.
Requirements
A remote streamable HTTP endpoint; no package, account, API key or environment variable is declared. Network access to the store's host is needed.
Before you install
The README states that checkout and payment require explicit human confirmation and that agents must never capture card details or CVVs; order tokens and customer data should stay private and admin endpoints are off limits. Only the two search and documentation tools are exposed here, but the underlying REST API also includes cart sync and order endpoints that write data.

Installation

In SourceWeft

  1. Open Alshhbaa Copperware — نحاسيات الشهباء in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Alshhbaa%2Fstore/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "alshhbaa-copperware": {
      "type": "http",
      "url": "https://shop.alshhbaa.com/.well-known/mcp"
    }
  }
}

README

Alshhbaa Brassware AI Agent Kit 🏺✨

[License: MIT] [Agent Plugins] [OpenAPI] [MCP] [Smithery] [skills.sh]

The official AI Agent Integration Kit for Alshhbaa Brassware (متجر نحاسيات الشهباء) — 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 Brassware 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 Brassware 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):
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 Brassware 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 Brassware (متجر نحاسيات الشهباء).

Source: README.md at commit c4e6856

Tools

2

search_products

Search Alshhbaa Copperware Products

Search public Alshhbaa Copperware product suggestions without mutating cart or checkout.

Parameterslimitqueryrequired

read_docs

Read Alshhbaa Copperware Developer Docs

Read Alshhbaa Copperware API, auth, pricing, OpenAPI, llms.txt, agent skills, and MCP developer documentation.

Parameterspathrequired

Version history

1
  1. v1.0.1LatestOct 18, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts