{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
  "name": "com.thellmrank/llmrank",
  "description": "Ranked, fully explainable search over merchant products and services for AI shopping queries.",
  "version": "1.0.0",
  "websiteUrl": "https://thellmrank.com",
  "documentationUrl": "https://thellmrank.com/docs/ranking",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://thellmrank.com/mcp",
      "headers": [
        {
          "name": "Authorization",
          "description": "Bearer <LLMRank API key>, created in the merchant console under Settings.",
          "isRequired": true,
          "isSecret": true
        }
      ]
    }
  ],
  "tools": [
    {
      "name": "search_products",
      "title": "Search products and services",
      "description": "Ranked search across every searchable listing. Returns prices, availability, merchant and a per-component explanation of the ranking.",
      "inputSummary": "query: string, limit?: 1-50, category?: string, brand?: string, max_price?: number, min_price?: number, availability?: in_stock|out_of_stock|preorder|backorder, listing_type?: product|service, explain?: boolean",
      "readOnly": true
    },
    {
      "name": "get_product_details",
      "title": "Get product details",
      "description": "Full detail for one listing by id or SKU, including attributes and policies.",
      "inputSummary": "product_id?: uuid, sku?: string (one of the two is required)",
      "readOnly": true
    },
    {
      "name": "compare_products",
      "title": "Compare products",
      "description": "Side-by-side comparison of 2-6 listings on price, rating and shared attributes.",
      "inputSummary": "product_ids: uuid[] (2-6)",
      "readOnly": true
    },
    {
      "name": "check_availability",
      "title": "Check availability",
      "description": "Live stock, price and agent-checkout status for up to 20 listings.",
      "inputSummary": "product_ids: uuid[] (1-20)",
      "readOnly": true
    },
    {
      "name": "get_merchant_info",
      "title": "Get merchant info",
      "description": "Merchant identity, domain-verification status, shipping and returns policies.",
      "inputSummary": "merchant_id: uuid",
      "readOnly": true
    },
    {
      "name": "explain_ranking",
      "title": "Explain ranking",
      "description": "Transparency tool: the six weighted components behind a listing's position for a query, with the concrete fixes that would raise it.",
      "inputSummary": "product_id: uuid, query: string",
      "readOnly": true
    }
  ]
}