# Alshhbaa Copperware — نحاسيات الشهباء
> Arabic-first Saudi retail store specializing in luxury handcrafted brass chandeliers, chandelier accessories and spare parts (glass cups "kassat" and lampshades), classic brass lamps, wall sconces, and flush mounts.

Operated by شركة نحاسيات الشهباء in Jeddah, Saudi Arabia. Public agent-readable surfaces expose the catalog and checkout helpers. Keep Arabic product names and option labels. Prices appear in SAR, including VAT; stock, options, shipping and totals must be checked live.

Do not use Alshhbaa Copperware for staff administration, inventory mutation, unpublished products, or delegated payments. Order submission requires explicit user confirmation of items, quantities, customer details, delivery and final total. Customer order tokens and personal data remain private.

## Shop and Business
- [Homepage](https://shop.alshhbaa.com/): Storefront and featured collections.
- [Products](https://shop.alshhbaa.com/products): Published catalog with current details and availability.
- [Categories](https://shop.alshhbaa.com/categories): Product collections and category navigation.
- [Business briefing](https://shop.alshhbaa.com/llm-info.html): Verified company facts, contacts, updates, FAQs and review date.
- [Structured business data](https://shop.alshhbaa.com/schema.jsonld): Schema.org Organization, OnlineStore and WebSite, shared with homepage markup.
- [Markdown homepage](https://shop.alshhbaa.com/index.md): Compact storefront summary.

## Policies
- [Shipping](https://shop.alshhbaa.com/shipping): Delivery coverage, charges and estimates.
- [Returns](https://shop.alshhbaa.com/returns): Return conditions, seven-day window and actual return shipping costs.
- [Terms](https://shop.alshhbaa.com/terms): Retail purchase terms.
- [Privacy](https://shop.alshhbaa.com/privacy): Customer-data policy.
- [Pricing](https://shop.alshhbaa.com/pricing.md): SAR prices, VAT, shipping examples and free public API access.

## Use Cases
- [Developer portal](https://shop.alshhbaa.com/developers): Search product suggestions, compare products, validate cart lines and prepare checkout.
- [API documentation](https://shop.alshhbaa.com/docs/api): Public capabilities and request guidance; submit checkout only after user approval.
- [OpenAPI 3.1 specification](https://shop.alshhbaa.com/openapi.json): Endpoint schemas including catalog pagination, cart sync and shipping helpers; async invoice jobs at POST /api/orders/{id}/invoice/jobs return 202 Accepted for token-authorized polling.
- [MCP server](https://shop.alshhbaa.com/.well-known/mcp): Render in-agent UI through MCP Apps resources and read the catalog.

## Agent Discovery and Permissions
- [Capability narrative](https://shop.alshhbaa.com/agenticweb.md): Implemented integrations, payment handoff and limits; no A2A or NLWeb server.
- [Action permissions](https://shop.alshhbaa.com/.well-known/agent-permissions.json): Allowed resources, consent requirements and private administration boundaries.
- [Agent directory](https://shop.alshhbaa.com/.well-known/agent-card.json): Available shopping capabilities and implemented interfaces.
- [Shopping skill catalog](https://shop.alshhbaa.com/.well-known/agent-skills/index.json): Discoverable shopping instructions with a content digest.
- [Shopping skill](https://shop.alshhbaa.com/.well-known/agent-skills/alshhbaa-store-shopping/SKILL.md): Catalog browsing, cart validation and human-confirmed checkout workflow.
- [MCP server card](https://shop.alshhbaa.com/.well-known/mcp/server-card.json): Transport, tools and server documentation.
- [WebMCP registration](https://shop.alshhbaa.com/webmcp-registration.js): Read-only browser tools; the hydrated storefront adds cart tools.
- [Commerce profile](https://shop.alshhbaa.com/.well-known/ucp): Browser checkout, transaction policy and retail terms; native UCP sessions and delegated payments are unavailable.
- [API catalog](https://shop.alshhbaa.com/.well-known/api-catalog): Machine-readable API discovery links.
- [Agent plugin manifest](https://shop.alshhbaa.com/.well-known/plugin.json): Agent plugins manifest conforming to agent-plugins.org schema.
- [Public agent kit repository](https://github.com/Alshhbaa/alshhbaa-agent-kit): Open-source agent kit, tools, and integration schemas.

## Section Indices
- [Developer documentation index](https://shop.alshhbaa.com/docs/llms.txt): Focused index for developer APIs and schemas.
- [Products catalog index](https://shop.alshhbaa.com/products/llms.txt): Focused index for chandeliers, lamps, and catalog products.
- [Articles and guides index](https://shop.alshhbaa.com/articles/llms.txt): Focused index for chandelier selection and buying guides.

## Optional
- [Developer index](https://shop.alshhbaa.com/developers/llms.txt): Extended integration references.
- [Authentication guide](https://shop.alshhbaa.com/auth.md): Anonymous catalog access and customer order-token requirements.
- [API versioning](https://shop.alshhbaa.com/versioning.md): Versions and compatibility.
- [Webhooks](https://shop.alshhbaa.com/webhooks.md): Supported webhook integration and verification.
- [ARD AI catalog](https://shop.alshhbaa.com/.well-known/ai-catalog.json): Additional agent resource discovery.