gridscoot
getting started

Quickstart

Get an agent calling Gridscoot in under 3 minutes.

Install

Add the MCP server to your agent’s config. For Claude Desktop:

claude_desktop_config.json
{
  "mcpServers": {
    "gridscoot": {
      "command": "npx",
      "args": ["-y", "@gridscoot/mcp"]
    }
  }
}

Restart Claude. The tools appear under the 🔧 menu. Other agents (Cline, OpenWebUI, Ollama) follow the same package; check the install switcher on the landing page for client-specific config paths.

Your first call

Ask the agent something it would need pricing for:

prompt
"Find me a Sony WH-1000XM5 in Australia, cheapest with 2-day delivery."

The agent decides which tool to call. In this case it picks search_products, then potentially follows up with get_price_history to verify the deal is genuine.

Anatomy of a response

Every tool returns structured JSON. The agent reads it and decides what to surface to you. Here’s what comes back from search_products:

response.json
{
  "query": "sony wh-1000xm5",
  "results": [
    {
      "product": {
        "id": "1",
        "title": "Sony WH-1000XM5 Noise Cancelling Headphones",
        "brand": "Sony",
        "mpn": "WH1000XM5B",
        "category_path": ["electronics", "audio", "headphones"]
      },
      "best_offer": {
        "retailer": { "slug": "ebay-au", "name": "eBay Australia" },
        "price_aud": 445.55,
        "shipping_aud": 12.40,
        "total_aud": 457.95,
        "in_stock": true,
        "product_url": "https://ebay.example.com/p/wh-1000xm5"
      },
      "match_confidence": "high"
    }
  ],
  "query_meta": {
    "search_method": "pg_trgm + word_similarity",
    "data_source_advisory": "Early-access catalogue: …"
  }
}

The 6 tools

tooldescription
search_productsGTIN + title search across the deduped catalogue.
compare_productAll in-stock offers for one canonical product.
get_price_history30/90/365-day series with fake-discount flagging.
check_availabilityLive in-stock + delivery ETA at a retailer.
list_retailersActive feeds + status (mirrors /status).
track_priceSubscribe to drop alerts (Pro tier).

Where to next