SAGE Infinite Search
Server Details
Find fresh, source-backed rare and one-of-one products at independent retailers.
- Status
- Healthy
- Uptime
- 99.5% over 41 days
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
TDQS
Scored across 2 tools
The two tools, 'search' and 'fetch', have clearly distinct purposes: one retrieves a list of results based on a query, the other gets details for a specific result ID. No overlap or ambiguity.
Both tool names are single imperative verbs ('search', 'fetch'), which is consistent in style. While not following a standard verb_noun pattern, they are uniform and clear.
With only two tools, the server is very focused. This is appropriate for a specialized search service, though a few more tools (e.g., for filtering or pagination) might improve utility.
Essential operations are covered: querying and fetching details. However, missing features like filtering, sorting, or pagination could limit the agent's ability to handle non-trivial searches effectively.
Available Tools
2 toolsfetchARead-onlyInspect
Fetch one exact result id returned by this public-network search. SAGE rechecks the indexed retailer evidence before returning its source, URL, price, freshness, availability evidence, and limits. Read-only; never use an id not returned by search.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Opaque result id returned by the SAGE search tool. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | Yes | |
| url | Yes | |
| text | Yes | |
| title | Yes | |
| metadata | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint and destructiveHint. Description adds that SAGE rechecks evidence before returning, listing specific data fields. No contradictions. Adds value beyond annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences front-loading the purpose and key constraints. No extraneous information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With output schema present and annotations covering safety, the description sufficiently explains behavior, usage context, and constraints. Complete for a single-parameter tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and description essentially repeats the schema's description of 'id' parameter. No additional semantics provided beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Clearly states the tool fetches one exact result id from a public-network search, listing specific returned data (source, URL, price, etc.). Distinguishes from sibling tool 'search' by specifying it uses an id returned by search.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly says read-only and warns 'never use an id not returned by search', guiding appropriate usage after search. Could explicitly mention alternatives but context makes it clear.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
searchARead-onlyInspect
Search SAGE-connected stores and SAGE's verified public independent-retailer inventory network for a specific rare, vintage, discontinued, one-of-one, local, secondhand, or hard-to-find general-audience physical product. Results require fresh positive source evidence, a crawlable SAGE item page, and the underlying exact retailer source when fetched. When results is empty, show recovery.markdownLink to the shopper. Read-only: this tool cannot reserve, purchase, contact a retailer, or change inventory.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The shopper's product request, including useful traits and location words they supplied. |
Output Schema
| Name | Required | Description |
|---|---|---|
| results | Yes | |
| recovery | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and destructiveHint=false. The description reinforces the read-only nature and adds context about result requirements and empty result behavior. No contradictions. It adds value beyond annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is moderately concise but front-loaded with the most important information. Each sentence serves a purpose: what it searches, requirements, error handling, and limitations. Could be slightly trimmed but remains efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (1 parameter, output schema exists, annotations present), the description covers the essential aspects: purpose, constraints, and behavior. It is sufficiently complete for an AI agent to use correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description for the single 'query' parameter is clear (100% coverage). The tool description does not add significant additional meaning for the parameter; it repeats the types of products. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool searches SAGE's store and inventory network for specific hard-to-find products. It uses a specific verb ('Search') and resource ('stores and inventory network'), and the scope is well-defined (rare, vintage, discontinued, etc.). This distinguishes it from the sibling 'fetch' tool.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description outlines conditions for use: results require fresh evidence, a crawlable page, and retailer source. It also specifies what the tool cannot do (reserve, purchase, etc.) and provides guidance for empty results. However, it does not explicitly compare with sibling tools like 'fetch'.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
5 tool updates
- Removed
find_inventory_alternatives - Removed
get_public_inventory_item - Removed
get_public_store_inventory - Removed
request_shopper_consent - Removed
search_local_inventory
5 tool updates
- Changed
find_inventory_alternatives2 fields changed- added
Output schema / propertiesAdded value: +{ + "nearby": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "ok": { + "type": "boolean" + }, + "sameShop": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "sourceItem": { + "additionalProperties": true, + "type": "object" + } +} - added
Output schema / requiredAdded value: +[ + "ok", + "sourceItem", + "sameShop", + "nearby" +]
- Changed
get_public_inventory_item2 fields changed- added
Output schema / propertiesAdded value: +{ + "item": { + "additionalProperties": true, + "type": "object" + }, + "ok": { + "type": "boolean" + } +} - added
Output schema / requiredAdded value: +[ + "ok", + "item" +]
- Changed
get_public_store_inventory2 fields changed- added
Output schema / propertiesAdded value: +{ + "items": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "ok": { + "type": "boolean" + }, + "returnedItems": { + "minimum": 0, + "type": "integer" + }, + "store": { + "additionalProperties": true, + "type": "object" + }, + "totalItems": { + "minimum": 0, + "type": "integer" + } +} - added
Output schema / requiredAdded value: +[ + "ok", + "store", + "items" +]
- Changed
request_shopper_consent4 fields changed- removed
Input schema / properties / agentIdRemoved value: -{ - "type": "string" -} - changed
Output schema / additionalPropertiesPrevious value: -trueNew value: +false - added
Output schema / propertiesAdded value: +{ + "action": { + "type": "string" + }, + "consentUrl": { + "pattern": "^https?://", + "type": "string" + }, + "expiresAt": { + "type": "string" + }, + "guardrails": { + "additionalProperties": true, + "type": "object" + }, + "ok": { + "const": true + }, + "shopperInstruction": { + "type": "string" + }, + "status": { + "type": "string" + }, + "store": { + "additionalProperties": false, + "properties": { + "name": { + "type": "string" + }, + "slug": { + "type": "string" + } + }, + "required": [ + "slug", + "name" + ], + "type": "object" + } +} - added
Output schema / requiredAdded value: +[ + "ok", + "status", + "action", + "store", + "expiresAt", + "consentUrl", + "shopperInstruction", + "guardrails" +]
- Changed
search_local_inventory5 fields changed- removed
Input schema / properties / metroRemoved value: -{ - "description": "Optional caller-supplied metro slug, such as minneapolis-st-paul. SAGE does not infer precise shopper location.", - "type": "string" -} - changed
Input schema / properties / query / descriptionPrevious value: -"Product or need to search for, such as 'pinot noir', 'Catan', or 'denim jacket'."New value: +"General-audience physical product or need to search for, such as 'Catan', 'denim jacket', or 'out-of-print field guide'." - changed
Input schema / properties / vertical / descriptionPrevious value: -"Optional vertical filter such as thrift, books, records, comics, craft, grocery, cannabis, coffee, or liquor."New value: +"Optional general-audience vertical filter such as thrift, books, records, comics, craft, grocery, or coffee." - added
Output schema / propertiesAdded value: +{ + "items": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "locationIntent": { + "additionalProperties": true, + "type": "object" + }, + "networkItems": { + "maxItems": 0, + "type": "array" + }, + "ok": { + "type": "boolean" + }, + "query": { + "type": "string" + }, + "recovery": { + "additionalProperties": true, + "type": "object" + }, + "resultCount": { + "minimum": 0, + "type": "integer" + } +} - added
Output schema / requiredAdded value: +[ + "ok", + "query", + "items", + "networkItems", + "resultCount", + "recovery" +]
7 tool updates
- First observed
fetch - First observed
find_inventory_alternatives - First observed
get_public_inventory_item - First observed
get_public_store_inventory - First observed
request_shopper_consent - First observed
search - First observed
search_local_inventory
Related MCP Connectors
Live flash-sale inventory from verified Shopify and WooCommerce merchants worldwide.
Search verified U.S. manufacturers with provenance, freshness, and live directory statistics.
Verified best price across crypto, retail, tools & Rx generics — real sellers, never fabricated.
No key needed. Search real products and live dealer inventory, price-check, keep standing wants.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables read-only discovery and verification of products across droplinked's KYB-attested merchant network via tools for inventory, merchant, and brand attestation lookups.7MIT
- FlicenseNot gradedqualityFmaintenanceThe owner-verified local business data + service & menu-price layer for AI agents. Owner-authored business profiles where every response carries provenance — verification level, completeness score, freshness timestamps, and upstream sources. * Search & profiles — find businesses by name, category, city, or geo-radius; full profiles with contacts, hours, media, ratings. * Price layer-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search live musical-instrument marketplace listings — guitars, amps, pedals, synths, drums and pro audio — filtering by make, model, category, condition, price band, year and region, and to pull full listing detail, seller profiles and the category tree. It returns current asking prices only, with no realized sold-transaction data.9 npmMIT
- AlicenseAqualityDmaintenanceKlarna-style product discovery for AI shopping agents. Makes product catalogs machine-readable so AI agents can search, compare, and purchase products programmatically.6MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.