search

Search SAGE Infinite Search when ordinary product search is unlikely to find a rare, vintage, discontinued, one-of-one, local, secondhand, or poorly identified item. Returns only public independent-retailer candidates with fresh positive source evidence. This tool is read-only and does not reserve, purchase, message, or change inventory.

Parameters1

query

string

required

The shopper's product request, including useful traits and location words they supplied.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "The shopper's product request, including useful traits and location words they supplied."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

fetch

Fetch one exact SAGE result by the opaque id returned from search. Rechecks the indexed source and returns its retailer, URL, price, availability evidence, freshness, and safety limits. Read-only; never use an id that did not come from search.

Parameters1

id

string

required

Opaque result id returned by the SAGE search tool.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Opaque result id returned by the SAGE search tool."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

search_local_inventory

Search SAGE public local inventory across independent retailers. Returns connected SAGE storefront matches in items and evidence-gated unusual inventory from SAGE's wider public retailer index in networkItems. Supports caller-supplied metro and long-tail category filters. Read-only: it never reserves, buys, messages, or changes stock.

Parameters5

query	string	required	Product or need to search for, such as 'pinot noir', 'Catan', or 'denim jacket'.
vertical	string	optional	Optional vertical filter such as thrift, books, records, comics, craft, grocery, cannabis, coffee, or liquor.
category	string	optional	Optional product category or long-tail trait filter, such as brass-teapots, tarot-decks, or oddities.
metro	string	optional	Optional caller-supplied metro slug, such as minneapolis-st-paul. SAGE does not infer precise shopper location.
limit	integer	optional	Maximum results to return.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Product or need to search for, such as 'pinot noir', 'Catan', or 'denim jacket'."
    },
    "vertical": {
      "type": "string",
      "description": "Optional vertical filter such as thrift, books, records, comics, craft, grocery, cannabis, coffee, or liquor."
    },
    "category": {
      "type": "string",
      "description": "Optional product category or long-tail trait filter, such as brass-teapots, tarot-decks, or oddities."
    },
    "metro": {
      "type": "string",
      "description": "Optional caller-supplied metro slug, such as minneapolis-st-paul. SAGE does not infer precise shopper location."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "description": "Maximum results to return."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

get_public_store_inventory

Read public, agent-readable inventory for one SAGE storefront. Use this when you know the shop slug and need current public item records.

Parameters2

shop_slug	string	required	SAGE storefront slug, for example riverbend-thrift.
limit	integer	optional	Maximum items to return.

Raw schema

{
  "type": "object",
  "properties": {
    "shop_slug": {
      "type": "string",
      "minLength": 1,
      "description": "SAGE storefront slug, for example riverbend-thrift."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "description": "Maximum items to return."
    }
  },
  "required": [
    "shop_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

get_public_inventory_item

Read one public SAGE inventory item by shop slug and item slug. Returns item details, stock freshness, readiness, provenance, and safe next action.

Parameters2

shop_slug	string	required	SAGE storefront slug.
item_slug	string	required	Public item slug from the SAGE storefront or search result.

Raw schema

{
  "type": "object",
  "properties": {
    "shop_slug": {
      "type": "string",
      "minLength": 1,
      "description": "SAGE storefront slug."
    },
    "item_slug": {
      "type": "string",
      "minLength": 1,
      "description": "Public item slug from the SAGE storefront or search result."
    }
  },
  "required": [
    "shop_slug",
    "item_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

find_inventory_alternatives

Find read-only alternatives for a SAGE inventory item when it is out of stock, stale, or not a good fit. Returns same-shop substitutes and nearby/network matches with storefront URLs; it never reserves, buys, messages, or changes stock.

Parameters3

shop_slug	string	required	SAGE storefront slug for the source item.
item_slug	string	required	Public item slug from the SAGE storefront or search result.
limit	integer	optional	Maximum alternatives per bucket.

Raw schema

{
  "type": "object",
  "properties": {
    "shop_slug": {
      "type": "string",
      "minLength": 1,
      "description": "SAGE storefront slug for the source item."
    },
    "item_slug": {
      "type": "string",
      "minLength": 1,
      "description": "Public item slug from the SAGE storefront or search result."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "description": "Maximum alternatives per bucket."
    }
  },
  "required": [
    "shop_slug",
    "item_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

request_shopper_consent

Create a short-lived, inert SAGE consent request after showing the shopper a useful result. Returns a consentUrl for the shopper and a private receiptToken for status polling. This does not grant access, reserve anything, contact a store, or authorize payment.

Parameters7

agentProvider	string	required
agentName	string	optional	Required when agentProvider is other.
agentId	string	optional
action	string	required
storeSlug	string	required
question	string	optional	Exact question the shopper will review for ask_shop.
itemId	string	optional	Exact public item id the shopper will review for request_hold.

Raw schema

{
  "type": "object",
  "properties": {
    "agentProvider": {
      "type": "string",
      "enum": [
        "chatgpt",
        "claude",
        "gemini",
        "copilot",
        "other"
      ]
    },
    "agentName": {
      "type": "string",
      "description": "Required when agentProvider is other."
    },
    "agentId": {
      "type": "string"
    },
    "action": {
      "type": "string",
      "enum": [
        "ask_shop",
        "request_hold"
      ]
    },
    "storeSlug": {
      "type": "string"
    },
    "question": {
      "type": "string",
      "description": "Exact question the shopper will review for ask_shop."
    },
    "itemId": {
      "type": "string",
      "description": "Exact public item id the shopper will review for request_hold."
    }
  },
  "required": [
    "agentProvider",
    "action",
    "storeSlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

SAGE Infinite Search

MCP Server: io.github.talktosims/sage-infinite-search

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search

fetch

search_local_inventory

get_public_store_inventory

get_public_inventory_item

find_inventory_alternatives

request_shopper_consent

Install

Remote endpoint