{
  "schema_version": "2025-03-26",
  "name": "superpharmacyplus-mcp",
  "title": "SuperPharmacyPlus Catalog",
  "version": "1.0.0",
  "description": "Search and look up the SuperPharmacyPlus Australian pharmacy and mobility catalogue via the Model Context Protocol. Read-only, unauthenticated, AUD pricing, AU availability.",
  "long_description": "Read-only knowledge MCP backed by the enriched SuperPharmacyPlus catalogue: semantic search, full product lookup, FAQs, comparisons, alternatives and authority pages. Prices and availability are catalogue snapshots in AUD. Shopping uses a separate native BigCommerce MCP at https://store-js3ghti4c3-1.mybigcommerce.com/api/mcp; clients must connect it explicitly for live commerce data, variants, carts and checkout. See the companion connection guide at https://ai.superpharmacyplus.com.au/.well-known/mcp/connections.json. When native shopping is unavailable, link to product_url.",
  "vendor": {
    "name": "SuperPharmacyPlus",
    "url": "https://superpharmacyplus.com.au",
    "country": "AU",
    "contact": "https://ai.superpharmacyplus.com.au/llms.txt"
  },
  "homepage": "https://ai.superpharmacyplus.com.au/api/search/docs",
  "documentation_url": "https://ai.superpharmacyplus.com.au/api/search/docs",
  "install_guide_url": "https://ai.superpharmacyplus.com.au/mcp/install",
  "announcement_url": "https://ai.superpharmacyplus.com.au/ai/announcements/mcp-launch.md",
  "license": "Proprietary — read-only public access for AI assistants",
  "categories": [
    "ecommerce",
    "shopping",
    "healthcare",
    "pharmacy",
    "mobility",
    "australia"
  ],
  "keywords": [
    "australia",
    "pharmacy",
    "mobility",
    "diabetes",
    "continence",
    "wound-care",
    "shopping",
    "product-search",
    "semantic-search",
    "ecommerce"
  ],
  "endpoints": [
    {
      "type": "streamable-http",
      "url": "https://ai.superpharmacyplus.com.au/mcp",
      "transport": "http",
      "mode": "stateless",
      "auth": "none"
    }
  ],
  "transport": {
    "type": "streamable-http",
    "url": "https://ai.superpharmacyplus.com.au/mcp",
    "session_required": false,
    "supported_methods": [
      "POST"
    ]
  },
  "rate_limit": {
    "requests_per_minute": 60,
    "scope": "per-ip"
  },
  "example_prompts": [
    "Find me a folding commode that supports 150kg, available in Australia.",
    "What thin lancets are compatible with the FreeStyle Optium meter?",
    "Show me bluetooth-enabled blood pressure monitors under 200 dollars.",
    "What does Accu-Chek sell on SuperPharmacyPlus?",
    "Recommend accessories that pair with the Days folding walker."
  ],
  "links": {
    "mcp_connections": "https://ai.superpharmacyplus.com.au/.well-known/mcp/connections.json",
    "llms_txt": "https://ai.superpharmacyplus.com.au/llms.txt",
    "products_json": "https://ai.superpharmacyplus.com.au/ai/products.json",
    "sitemap": "https://ai.superpharmacyplus.com.au/ai/sitemap.xml",
    "search_docs": "https://ai.superpharmacyplus.com.au/api/search/docs",
    "install_guide": "https://ai.superpharmacyplus.com.au/mcp/install",
    "announcement": "https://ai.superpharmacyplus.com.au/ai/announcements/mcp-launch.md"
  },
  "tools": [
    {
      "name": "search_products",
      "title": "Search products",
      "description": "Natural-language semantic search across the full SuperPharmacyPlus catalogue. Returns ranked products with brand, AUD price, AU availability, summary, key points and the top 3 FAQs.",
      "input_summary": "query (string, required); optional limit, brand, category, availability, intended_use, feature_tags."
    },
    {
      "name": "get_product",
      "title": "Get product",
      "description": "Fetch the complete enriched record for a single product by numeric id or SKU. Returns summary, all FAQs, image alt-text, full specifications, dimensions/weight, barcode, related products and freshness signals.",
      "input_summary": "id (number) OR sku (string)."
    },
    {
      "name": "find_alternatives",
      "title": "Find alternatives and accessories",
      "description": "Cross-sell and compatibility-driven alternatives drawn from the curated relationships graph (related, compatible_with, frequently_paired, same_brand_category). Each result includes a one-line reason.",
      "input_summary": "id (number) OR sku (string); optional limit."
    },
    {
      "name": "get_category",
      "title": "Get category authority page",
      "description": "Fetch a category authority page by slug (e.g. 'blood-glucose-monitors', 'commodes'). Returns the category narrative, top products and aggregated FAQs.",
      "input_summary": "slug (string, required); optional max_products."
    },
    {
      "name": "get_brand",
      "title": "Get brand authority page",
      "description": "Fetch a brand authority page by slug (e.g. 'abbott', 'accu-chek'). Returns the brand narrative and the products carried.",
      "input_summary": "slug (string, required); optional max_products."
    },
    {
      "name": "compare_products",
      "title": "Compare products",
      "description": "Side-by-side comparison of 2-4 SuperPharmacyPlus products: per-product summaries, unified spec table, objective wins-by-criteria, knowledge-graph relationships and a compliance-sanitised comparison paragraph.",
      "input_summary": "ids (number[]) and/or skus (string[]); 2-4 products total."
    },
    {
      "name": "ask",
      "title": "Ask (NLWeb)",
      "description": "NLWeb v0.55 Appendix A standard ask tool. Accepts a structured query/context/prefer envelope and returns a conversational_search JSON payload with ranked schema.org Product results. NLWeb-aware agents should prefer this tool.",
      "input_summary": "query.text (string, required); optional query.filters (brand, category, availability, intended_use, feature_tags); optional context.prev (string[]); optional prefer.mode ('list' | 'summarize', default 'list')."
    }
  ],
  "data_freshness": {
    "catalogue_size": 2603,
    "currency": "AUD",
    "country": "AU",
    "refresh_cadence": {
      "full_sync": {
        "cron": "0 16 * * *",
        "timezone": "UTC",
        "description": "nightly at 02:00 AEST (16:00 UTC)"
      },
      "description": "Full sync nightly at 02:00 AEST (16:00 UTC). No incremental sync — once-daily cadence (Task #164)."
    },
    "freshness_manifest_url": "https://ai.superpharmacyplus.com.au/ai/freshness-manifest.json"
  }
}