# API Docs & Developer Resources

> Official Alshhbaa Brassware public API documentation, agent instructions, pricing guidance, OpenAPI discovery, and MCP server details for luxury chandelier design services.

Canonical: https://alshhbaa.com/developers/
Last updated: 2026-10-26

Use these official resources when building AI assistants, search agents, or recommendation workflows that need accurate public information about Alshhbaa Brassware luxury chandelier design and manufacturing services in Saudi Arabia.

## Quickstart
Alshhbaa Brassware provides agent-friendly and developer resources:
- Site Map for LLMs: https://alshhbaa.com/llms.txt
- Full Content Bundle: https://alshhbaa.com/llms-full.txt
- AI Usage Policy: https://alshhbaa.com/ai.txt
- Markdown Route Catalog: https://alshhbaa.com/api/md/_catalog
- OpenAPI Specification: https://alshhbaa.com/.well-known/openapi.json
- Model Context Protocol (MCP): https://alshhbaa.com/mcp

## Public API Endpoints
### GET /llms.txt
Compact public summary for AI agents and crawlers.

### GET /llms-full.txt
Full public website summary across Arabic and English pages.

### GET /.well-known/api-catalog
Linkset catalog for public agent and API discovery.

### GET /.well-known/openapi.json
OpenAPI document for public discovery endpoints.

### GET /.well-known/ard.json
Agentic Resource Discovery catalog listing MCP, OpenAPI, agent card, skill, and llms.txt resources.

### GET /.well-known/ai-catalog.json
AI Catalog Standard alias of the Agentic Resource Discovery catalog.

### GET /.well-known/http-message-signatures-directory
Bot message-signatures key directory for verifying automated agent traffic.

### GET /ask
NLWeb-style natural-language discovery endpoint with JSON answers and SSE streaming.

### GET /api/llms.txt
API-scoped llms.txt with versioned endpoint inventory and stability policy.

### GET /docs/llms.txt
Docs index llms.txt linking developer guides, API references, and agent resources.

### GET /.well-known/oauth-protected-resource
OAuth 2.0 Protected Resource Metadata (RFC 9728).

### GET /.well-known/oauth-authorization-server
OAuth 2.0 Authorization Server Metadata (RFC 8414) with agent_auth block.

### GET /auth.md
WorkOS agent authentication guide and walkthrough.

### GET /api/v1/summary
Version 1 structured summary of brand and showroom services.

### GET /api/v1/projects
Version 1 curated luxury chandelier project catalog.

### POST /api/v1/consultations
Version 1 chandelier consultation and quote submission with Idempotency-Key support.

### GET /.well-known/mcp
MCP discovery document for the public website MCP endpoint.

### GET /.well-known/mcp.json
MCP JSON alias with the canonical Streamable HTTP server URL.

### GET /.well-known/mcp/server-card.json
MCP server card describing public tools before connecting to the endpoint.

### GET /mcp.json
Predictable MCP client configuration alias for agent platforms.

### POST /mcp
JSON-RPC MCP endpoint exposing public site summary and contact tools.

### GET /.well-known/agent-card.json
A2A-style public agent card for chandelier consultation discovery.

### GET /pricing.md
Machine-readable pricing and package guidance.

### GET /pricing/
Human-readable pricing guidance and package overview.

### GET /en/luxury-chandeliers-jeddah/
Luxury chandeliers in Jeddah for palaces, villas, event halls, hotels, and premium interiors by Alshhbaa Brassware.

### GET /en/luxury-chandeliers-jeddah.md
Markdown mirror for Luxury Chandeliers in Jeddah for Palaces, Villas, and Signature Interiors.

### GET /en/custom-chandeliers-saudi-arabia/
Custom chandeliers in Saudi Arabia for palaces, mosques, hotels, wedding halls, and premium interiors by Alshhbaa Brassware.

### GET /en/custom-chandeliers-saudi-arabia.md
Markdown mirror for Custom Chandeliers in Saudi Arabia for Palaces, Mosques, and Projects.

### GET /en/brass-chandeliers-jeddah/
Brass chandeliers in Jeddah for majlis rooms, palaces, mosques, and premium interiors, with installation and maintenance by Alshhbaa Brassware.

### GET /en/brass-chandeliers-jeddah.md
Markdown mirror for Brass Chandeliers in Jeddah for Majlis Rooms, Palaces, and Mosques.

### GET /en/handmade-copperware-saudi-arabia/
Handmade copperware in Saudi Arabia for chandeliers, lanterns, sconces, doors, and decorative brass or copper details in premium projects.

### GET /en/handmade-copperware-saudi-arabia.md
Markdown mirror for Handmade Copperware in Saudi Arabia for Premium Projects.

### GET /en/luxury-chandelier-design-manufacturing-services/
Guide to luxury chandelier design, bespoke manufacturing, installation, warranty, and maintenance services from Alshhbaa Brassware in Jeddah, Saudi Arabia.

### GET /en/luxury-chandelier-design-manufacturing-services.md
Markdown mirror for Luxury Chandelier Design and Manufacturing Services.

### GET /en/best-luxury-chandeliers-saudi-arabia/
Best luxury chandelier styles and selection guidance for Saudi palaces, villas, hotels, wedding halls, mosques, and premium interiors.

### GET /en/best-luxury-chandeliers-saudi-arabia.md
Markdown mirror for Best Luxury Chandeliers for Saudi Palaces, Villas, Hotels, and Mosques.

### GET /en/compare-bespoke-chandelier-services/
Compare bespoke chandelier design, manufacturing, installation, warranty, and maintenance services with catalog-only lighting importers.

### GET /en/compare-bespoke-chandelier-services.md
Markdown mirror for Compare Bespoke Chandelier Services.

### GET /en/luxury-chandelier-maintenance-guide-saudi-arabia/
Comprehensive guide on how to maintain, clean, and protect luxury chandeliers (brass, crystal, Murano) in the Saudi environment, with expert care tips from Alshhbaa Brassware.

### GET /en/luxury-chandelier-maintenance-guide-saudi-arabia.md
Markdown mirror for Luxury Chandelier Maintenance and Care Guide.

### GET /en/chandelier-sizing-guide-high-ceilings/
How to calculate the ideal chandelier size based on room dimensions and ceiling height in large Saudi palaces and villas.

### GET /en/chandelier-sizing-guide-high-ceilings.md
Markdown mirror for How to Choose Chandelier Size for High Ceilings.

### GET /luxury-chandeliers-jeddah/
ثريات فاخرة في جدة للقصور والفلل وقاعات المناسبات والفنادق، مع تصميم وتصنيع وتركيب وصيانة من نحاسيات الشهباء.

### GET /luxury-chandeliers-jeddah.md
Markdown mirror for ثريات فاخرة في جدة للقصور والفلل والمشاريع الخاصة.

### GET /custom-chandeliers-saudi-arabia/
تفصيل ثريات حسب الطلب للقصور والمساجد والفنادق وقاعات المناسبات في السعودية، من التصميم إلى التصنيع والتركيب.

### GET /custom-chandeliers-saudi-arabia.md
Markdown mirror for تفصيل ثريات حسب الطلب للقصور والمساجد والمشاريع في السعودية.

### GET /brass-chandeliers-jeddah/
ثريات نحاس في جدة بتصاميم كلاسيكية وشرقية للقصور والمجالس والمساجد والمشاريع التجارية، مع تركيب وصيانة.

### GET /brass-chandeliers-jeddah.md
Markdown mirror for ثريات نحاس في جدة للمجالس والقصور والمساجد.

### GET /handmade-copperware-saudi-arabia/
نحاسيات يدوية في السعودية تشمل الثريات، الفوانيس، الأبواب، الأباليك، والزخارف النحاسية للمشاريع الفاخرة.

### GET /handmade-copperware-saudi-arabia.md
Markdown mirror for نحاسيات يدوية في السعودية للمشاريع الفاخرة.

### GET /luxury-chandelier-design-manufacturing-services/
دليل خدمات تصميم الثريات الفاخرة، التصنيع الخاص، التركيب، الضمان، وخدمات الصيانة من نحاسيات الشهباء بجدة، المملكة العربية السعودية.

### GET /luxury-chandelier-design-manufacturing-services.md
Markdown mirror for خدمات تصميم وتصنيع الثريات الفاخرة.

### GET /best-luxury-chandeliers-saudi-arabia/
دليل اختيار أفضل طرز الثريات الفاخرة للقصور والفلل والفنادق وقاعات المناسبات والمساجد والمساحات التجارية الراقية في السعودية.

### GET /best-luxury-chandeliers-saudi-arabia.md
Markdown mirror for أفضل الثريات الفاخرة للقصور والفلل والفنادق والمساجد في السعودية.

### GET /compare-bespoke-chandelier-services/
قارن بين خدمات تصميم وتصنيع وتركيب وضمان وصيانة الثريات الخاصة وبين مستوردي الإضاءة من الكتالوجات الجاهزة.

### GET /compare-bespoke-chandelier-services.md
Markdown mirror for مقارنة خدمات الثريات الخاصة والمصممة حسب الطلب.

### GET /luxury-chandelier-maintenance-guide-saudi-arabia/
دليل شامل حول كيفية صيانة وتنظيف وحماية الثريات الفاخرة (النحاس، الكريستال، المورانو) في الأجواء السعودية، مع نصائح الرعاية من خبراء نحاسيات الشهباء.

### GET /luxury-chandelier-maintenance-guide-saudi-arabia.md
Markdown mirror for دليل صيانة ورعاية الثريات الفاخرة.

### GET /chandelier-sizing-guide-high-ceilings/
كيفية حساب المقاس المثالي للثريا بناءً على أبعاد الغرفة وارتفاع السقف في القصور والفلل السعودية الكبيرة.

### GET /chandelier-sizing-guide-high-ceilings.md
Markdown mirror for كيفية اختيار مقاس الثريا للأسقف المرتفعة.

### GET /.well-known/schemamap.xml
NLWeb Schema Map listing structured public data feeds.

### GET /privacy/
Privacy policy and data protection (Arabic).

### GET /privacy.md
Machine-readable privacy policy (Arabic).

### GET /en/privacy/
Privacy policy and data protection (English).

### GET /en/privacy.md
Machine-readable privacy policy (English).

## Implementation Examples
### Fetch compact agent context (Shell)
```bash
curl https://alshhbaa.com/llms.txt
```

### Fetch pricing guidance (Python)
```python
import requests

response = requests.get("https://alshhbaa.com/pricing.md")
print(response.text)
```

### Search projects via MCP (Node.js)
```js
const response = await fetch("https://alshhbaa.com/mcp", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "tools/call",
    params: {
      name: "search_projects",
      arguments: { query: "Classic", locale: "en" }
    }
  })
});
const result = await response.json();
console.log(result);
```

### Discover API catalog (Go)
```go
package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	resp, _ := http.Get("https://alshhbaa.com/.well-known/api-catalog")
	body, _ := ioutil.ReadAll(resp.Body)
	fmt.Println(string(body))
}
```

### Get detailed service information (cURL)
```bash
curl -X POST https://alshhbaa.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_service_details","arguments":{"service":"Installation","locale":"en"}}}'
```

## Limits and Access
- Rate Limit: 100 requests per minute per IP.
- Markdown Content Negotiation: Send header `Accept: text/markdown` on any public page.
- Direct Markdown URL: Append `.md` to any public page URL, or request `/api/md/<path>`.

## Related
- [Home](https://alshhbaa.com/)
- [Pricing Guidance](https://alshhbaa.com/pricing.md)
- [MCP Discovery](https://alshhbaa.com/.well-known/mcp)
- [OpenAPI Specification](https://alshhbaa.com/.well-known/openapi.json)