{ "specVersion": "1.0", "host": { "hostname": "shisha-zone.com", "displayName": "Shisha Zone Philippines", "description": "The Philippines' premier e-commerce platform for shisha tobacco, hookahs, charcoal, and accessories. Serving Manila's top hotels and establishments for 21+ years.", "url": "https://www.shisha-zone.com", "logo": "https://www.shisha-zone.com/original-logo.webp", "contact": "https://www.shisha-zone.com/contact", "privacy": "https://www.shisha-zone.com/privacy", "terms": "https://www.shisha-zone.com/terms" }, "entries": [ { "identifier": "urn:air:shisha-zone.com:openapi:shisha-zone-api", "displayName": "Shisha Zone OpenAPI 3.1 Specification", "description": "Full OpenAPI 3.1.0 specification for the Shisha Zone public API. Covers products, orders, reviews, contact forms, distributor applications, promo codes, and shipping.", "type": "application/openapi+json", "url": "https://www.shisha-zone.com/.well-known/api-catalog/openapi.json", "representativeQueries": [ "How do I list all shisha products?", "What endpoints does Shisha Zone expose?", "How do I place an order at Shisha Zone?", "What is the API schema for product reviews?", "How do I validate a promo code?" ] }, { "identifier": "urn:air:shisha-zone.com:catalog:api-catalog", "displayName": "API Catalog (RFC 9727 Linkset)", "description": "RFC 9727 linkset pointing to the OpenAPI spec, human documentation, and health endpoint. Entry point for agent API discovery.", "type": "application/linkset+json", "url": "https://www.shisha-zone.com/.well-known/api-catalog", "representativeQueries": [ "Where is the Shisha Zone API documentation?", "What is the service description endpoint?", "How do I discover Shisha Zone APIs?" ] }, { "identifier": "urn:air:shisha-zone.com:mcp:server-card", "displayName": "MCP Server Card", "description": "Model Context Protocol server card (SEP-1649). Declares the MCP transport endpoint and advertised capabilities (tools, resources) for AI agent integration.", "type": "application/json", "url": "https://www.shisha-zone.com/.well-known/mcp/server-card.json", "representativeQueries": [ "What MCP tools does Shisha Zone expose?", "How do I connect to the Shisha Zone MCP server?", "What is the MCP endpoint for Shisha Zone?", "Can I use MCP to browse Shisha Zone products?" ] }, { "identifier": "urn:air:shisha-zone.com:agent-skills:index", "displayName": "Agent Skills Discovery Index", "description": "Agent Skills Discovery index listing all published skill documents for this site, with SHA-256 digests for change detection.", "type": "application/json", "url": "https://www.shisha-zone.com/.well-known/agent-skills/index.json", "representativeQueries": [ "What agent skills does Shisha Zone publish?", "How do I discover Shisha Zone agent capabilities?", "List the available skills for Shisha Zone." ] }, { "identifier": "urn:air:shisha-zone.com:oauth:protected-resource", "displayName": "OAuth 2.0 Protected Resource Metadata", "description": "RFC 9728 protected resource metadata. Declares authorization servers, bearer methods, and supported scopes. Most public APIs require no authentication.", "type": "application/json", "url": "https://www.shisha-zone.com/.well-known/oauth-protected-resource", "representativeQueries": [ "How do I authenticate with Shisha Zone APIs?", "Does Shisha Zone require OAuth tokens?", "What authorization server issues tokens for Shisha Zone?", "Are the Shisha Zone APIs public or protected?" ] }, { "identifier": "urn:air:shisha-zone.com:oauth:authorization-server", "displayName": "OAuth 2.0 Authorization Server Metadata", "description": "RFC 8414 authorization server metadata. Declares the issuer, supported grant types, and agent_auth block for agent registration via Google OAuth.", "type": "application/json", "url": "https://www.shisha-zone.com/.well-known/oauth-authorization-server", "representativeQueries": [ "How do agents register with Shisha Zone?", "What OAuth flows are supported?", "Where is the Shisha Zone identity provider?" ] }, { "identifier": "urn:air:shisha-zone.com:auth:auth-md", "displayName": "Auth.md Agent Authentication Guide", "description": "Human and machine-readable authentication guide for AI agents. Covers public endpoint access (no auth), Google OAuth login flow, and session management.", "type": "text/markdown", "url": "https://www.shisha-zone.com/auth.md", "representativeQueries": [ "How do I authenticate as an agent on Shisha Zone?", "What credentials do I need to call Shisha Zone APIs?", "Is there a guide for agent authentication at Shisha Zone?", "Can agents access Shisha Zone without a token?" ] }, { "identifier": "urn:air:shisha-zone.com:security:jwks", "displayName": "Web Bot Auth JWKS Directory", "description": "IETF Web Bot Auth public key set (JWKS). Used to verify HTTP Message Signatures on outbound requests from this site.", "type": "application/jwk-set+json", "url": "https://www.shisha-zone.com/.well-known/http-message-signatures-directory", "representativeQueries": [ "What public keys does Shisha Zone use for signing?", "Where is the Shisha Zone JWKS endpoint?", "How do I verify requests from Shisha Zone?" ] }, { "identifier": "urn:air:shisha-zone.com:api:products", "displayName": "Products API", "description": "Returns all shisha and hookah products with names, prices, categories, availability, badges, and signed image URLs. No authentication required.", "type": "application/json", "url": "https://www.shisha-zone.com/api/products", "representativeQueries": [ "List all shisha products available in the Philippines", "What hookahs does Shisha Zone sell?", "Show me Al Fakher products at Shisha Zone", "What charcoal brands are available?", "Which products are in stock at Shisha Zone?" ] }, { "identifier": "urn:air:shisha-zone.com:api:health", "displayName": "API Health Check", "description": "Returns system health status including GCP service account identity, GCS bucket access, and signBlob capability.", "type": "application/json", "url": "https://www.shisha-zone.com/api/catalog/health", "representativeQueries": [ "Is the Shisha Zone API operational?", "Check Shisha Zone API health status" ] } ] }