LLMRank

Connect an agent

LLMRank is an MCP server over Streamable HTTP plus a REST API. Six read-only tools query a live merchant catalog and return ranked results with the reasoning attached — the same six-component score the merchant sees. You need one API key, created by a merchant in the console under Settings.

MCP endpoint
https://thellmrank.com/mcp
Transport
streamable-http
Auth
Authorization: Bearer llmr_...
Server descriptor
https://thellmrank.com/.well-known/mcp/server.json

Quickstart

Add the block below, restart Claude Desktop, then ask it to search the catalog. claude_desktop_config.json

{
  "mcpServers": {
    "llmrank": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://thellmrank.com/mcp",
        "--header",
        "Authorization: Bearer llmr_YOUR_API_KEY"
      ]
    }
  }
}

Tools

search_products

Ranked search across every searchable listing. Returns prices, availability, merchant and a per-component explanation of the ranking.

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

get_product_details

Full detail for one listing by id or SKU, including attributes and policies.

product_id?: uuid, sku?: string (one of the two is required)

compare_products

Side-by-side comparison of 2-6 listings on price, rating and shared attributes.

product_ids: uuid[] (2-6)

check_availability

Live stock, price and agent-checkout status for up to 20 listings.

product_ids: uuid[] (1-20)

get_merchant_info

Merchant identity, domain-verification status, shipping and returns policies.

merchant_id: uuid

explain_ranking

Transparency tool: the six weighted components behind a listing's position for a query, with the concrete fixes that would raise it.

product_id: uuid, query: string

Rate limits and etiquette

MCP tool calls are limited to 100 per minute per key; REST search allows 60 (free), 300 (pro) or 1000 (enterprise) per minute. Every response carries X-RateLimit-Remaining and X-RateLimit-Reset; over the limit you get a 429 with Retry-After. Report results a user acted on to POST https://thellmrank.com/api/v1/click — it is the only signal behind the Performance component.

Machine-readable references