Endpoints: 76,849MCP servers: 32,728Payout addresses: 3,825Paid calls: 6,146Letters: 84Defects: 3,892counted 1 min ago
teppi

Server definition

Hash
sha256:992488b8c78a64e913733eef8a997cd41c2e189dd98ce09cd58a049197be3860
What it is
What a remote MCP server returned when asked what it offers: 6 tools

The blob, as servednamed by its sha256

{ "instructions": "Edwin is the butler of theButler.network. Use these tools for shopping requests about products and their prices at online merchants: when the user wants to find, compare or choose something to buy, or asks what it costs, whether or not they name Edwin or theButler.network. Edwin reads merchant offers from affiliate product feeds across markets. Prices and the source_imported_at timestamp both come from merchant feed imports: the timestamp is the most recent import that still listed the offer. Present it as the age of the price, never as a current or checked price. Show the url so the user can view and buy. Each result starts with Edwin's presentation rules; follow them. Where a result shows a table with purchase links, show it with the links unchanged. Affiliate commission never affects ranking. Catalog titles are in the language of each market's merchants: put the product-type word of a query in that language (German for DE, AT and CH, Dutch for NL, French for FR, English for GB and US), whatever language the user writes in. Brand and model names belong in the query unchanged.", "tools": [ { "description": "Compare two to five products side by side: brand, category, price range across merchants, merchant count, and the lowest current offer for each. Use when the user is choosing between named products.", "inputSchema": { "additionalProperties": false, "properties": { "market": { "description": "ISO 3166-1 alpha-2 country code of the user's shopping market, e.g. DE, AT, NL, FR, GB, US. Infer from the user's context.", "pattern": "^[A-Za-z]{2}$", "type": "string" }, "pids": { "description": "Two to five product ids from previous Edwin tool results.", "items": { "type": "string" }, "maxItems": 5, "minItems": 2, "type": "array" } }, "required": [ "pids", "market" ], "type": "object" }, "name": "compare_products", "outputSchema": { "properties": { "empty_reason": { "description": "Machine-readable reason for an empty result. restricted_category: matches existed but fall into a product category this connector does not serve. no_match_in_market: nothing matched in this market. no_offers_for_product: the product has no merchant offer here at all. no_fresh_offers_for_product: the product has offers, but none is confirmed by the most recent import of its source, so there is no up-to-date price — do not quote an older one. query_too_short: the query carried no searchable terms. market_not_covered: no offers in this market at all. unknown_pid: no product with that id — call search_products for a real one. no_substantial_match: products matched, but none had a recognizable brand or publisher and the fields required for the product type — say so; the user can explicitly ask for unbranded or self-published items.", "enum": [ "no_match_in_market", "no_offers_for_product", "no_fresh_offers_for_product", "query_too_short", "market_not_covered", "unknown_pid", "restricted_category", "no_substantial_match" ], "type": "string" }, "market": { "type": "string" }, "note": { "description": "Plain-language explanation for the user. Set whenever the result is empty, and also when something about a non-empty result needs saying — for example that the ranking did not run and the order is the raw catalog order.", "type": [ "string", "null" ] }, "products": { "items": { "properties": { "best_offer": { "properties": { "currency": { "type": "string" }, "market": { "type": "string" }, "match_score": { "description": "Raw merge confidence behind match_tier, 0–1. Null when none is stored.", "type": [ "number", "null" ] }, "match_tier": { "description": "How confidently offers were merged into this catalog product: exact_gtin (GTIN match), strong_identifier (GTIN plus brand and MPN), attribute_match (brand and MPN), fuzzy (merchant item id only), unclassified (no confidence value stored). This is a product-level value, so every offer of one product carries the same tier.", "enum": [ "exact_gtin", "strong_identifier", "attribute_match", "fuzzy", "unclassified" ], "type": "string" }, "merchant": { "description": "Merchant name as delivered by the feed.", "type": "string" }, "pid": { "type": "string" }, "price": { "description": "Offer price in `currency`, as delivered by the feed.", "type": "number" }, "shipping": { "description": "Shipping cost. Always null: the merchant feeds behind this catalog do not carry shipping, so the price above is the item price alone — do not present it as a total.", "type": [ "number", "null" ] }, "source_imported_at": { "description": "ISO timestamp of the most recent merchant feed import that still listed this offer: the last import of its merchant feed whose check for removed offers finished cleanly, or the import that last changed the offer, whichever is later. It is the age of the feed data, not a statement that the price is current.", "type": [ "string", "null" ] }, "source_network": { "description": "Affiliate network the feed came from, e.g. awin, cj, rakuten, tradedoubler.", "type": "string" }, "source_type": { "description": "How this offer entered the catalog. All offers come from affiliate network feeds.", "enum": [ "affiliate_feed" ], "type": "string" }, "source_updated_at": { "deprecated": true, "description": "DEPRECATED — alias of source_imported_at with the identical value, kept only for existing clients and removed 30 days after this server version went live. Read source_imported_at instead.", "type": [ "string", "null" ] }, "stock_status": { "description": "'unknown' means the feed did not state stock, not that the item is unavailable.", "enum": [ "in_stock", "unknown" ], "type": "string" }, "unit_price_text": { "description": "Unit price exactly as the merchant feed states it, e.g. '2,60 € / 1 ml' or '1 kg = 12,99 €'. Present only when the feed provides one. When present, show it next to the price; never calculate a unit price yourself.", "type": "string" }, "url": { "description": "Link to view and buy at this merchant. Show this to the user.", "type": "string" } }, "required": [ "pid", "merchant", "source_type", "source_network", "source_imported_at", "source_updated_at", "market", "price", "currency", "shipping", "stock_status", "match_tier", "url" ], "type": [ "object", "null" ] }, "brand": { "type": [ "string", "null" ] }, "category": { "type": [ "string", "null" ] }, "merchant_count": { "type": "integer" }, "name": { "type": "string" }, "note": { "description": "Plain-language explanation for the user. Set whenever the result is empty, and also when something about a non-empty result needs saying — for example that the ranking did not run and the order is the raw catalog order.", "type": [ "string", "null" ] }, "pid": { "type": "string" }, "price_range": { "properties": { "currency": { "type": "string" }, "max": { "type": "number" }, "min": { "type": "number" } }, "required": [ "min", "max", "currency" ], "type": [ "object", "null" ] }, "url": { "description": "Link to view and buy this product — the same link as best_offer.url. Null when this product has no current offer in this market.", "type": [ "string", "null" ] } }, "required": [ "pid", "merchant_count" ], "type": "object" }, "type": "array" } }, "required": [ "market", "products" ], "type": "object" } }, { "description": "Find comparable products to a given product in the same market, optionally within a budget or with specific attribute changes. Use when the user asks for alternatives, cheaper equivalents, or \"something like X but Y\".", "inputSchema": { "additionalProperties": false, "properties": { "budget_max": { "description": "Upper price limit in the market currency, if the user states one.", "type": "number" }, "direction": { "default": "similar", "description": "Which way to look: 'cheaper' for lower-priced equivalents, 'better' for higher-priced ones, 'similar' for the same price class.", "enum": [ "cheaper", "similar", "better" ], "type": "string" }, "limit": { "default": 5, "description": "How many alternatives to return.", "maximum": 10, "minimum": 1, "type": "integer" }, "market": { "description": "ISO 3166-1 alpha-2 country code of the user's shopping market, e.g. DE, AT, NL, FR, GB, US. Infer from the user's context.", "pattern": "^[A-Za-z]{2}$", "type": "string" }, "must_have": { "description": "Attribute words the alternative must carry in its name, e.g. [\"oled\"] for \"like this one but OLED\". Matched against product title and brand.", "items": { "type": "string" }, "type": "array" }, "pid": { "description": "Product id exactly as returned by a previous Edwin tool result. Never invent one — call search_products first if you do not have a pid.", "type": "string" } }, "required": [ "pid", "market" ], "type": "object" }, "name": "find_alternatives", "outputSchema": { "properties": { "direction": { "enum": [ "cheaper", "similar", "better" ], "type": "string" }, "empty_reason": { "description": "Machine-readable reason for an empty result. restricted_category: matches existed but fall into a product category this connector does not serve. no_match_in_market: nothing matched in this market. no_offers_for_product: the product has no merchant offer here at all. no_fresh_offers_for_product: the product has offers, but none is confirmed by the most recent import of its source, so there is no up-to-date price — do not quote an older one. query_too_short: the query carried no searchable terms. market_not_covered: no offers in this market at all. unknown_pid: no product with that id — call search_products for a real one. no_substantial_match: products matched, but none had a recognizable brand or publisher and the fields required for the product type — say so; the user can explicitly ask for unbranded or self-published items.", "enum": [ "no_match_in_market", "no_offers_for_product", "no_fresh_offers_for_product", "query_too_short", "market_not_covered", "unknown_pid", "restricted_category", "no_substantial_match" ], "type": "string" }, "items": { "items": { "properties": { "availability": { "enum": [ "in_stock", "unknown" ], "type": "string" }, "badge": { "description": "Set on the one product Edwin's ranking picked, when a ranking ran.", "enum": [ "edwins_choice", null ], "type": [ "string", "null" ] }, "best_offer": { "description": "The cheapest current offer for this product in the market: which merchant, at what price, and the link. Same offer the `price` field is taken from. Call get_offers only when the user wants the full merchant list.", "properties": { "currency": { "type": "string" }, "market": { "type": "string" }, "match_score": { "description": "Raw merge confidence behind match_tier, 0–1. Null when none is stored.", "type": [ "number", "null" ] }, "match_tier": { "description": "How confidently offers were merged into this catalog product: exact_gtin (GTIN match), strong_identifier (GTIN plus brand and MPN), attribute_match (brand and MPN), fuzzy (merchant item id only), unclassified (no confidence value stored). This is a product-level value, so every offer of one product carries the same tier.", "enum": [ "exact_gtin", "strong_identifier", "attribute_match", "fuzzy", "unclassified" ], "type": "string" }, "merchant": { "description": "Merchant name as delivered by the feed.", "type": "string" }, "pid": { "type": "string" }, "price": { "description": "Offer price in `currency`, as delivered by the feed.", "type": "number" }, "shipping": { "description": "Shipping cost. Always null: the merchant feeds behind this catalog do not carry shipping, so the price above is the item price alone — do not present it as a total.", "type": [ "number", "null" ] }, "source_imported_at": { "description": "ISO timestamp of the most recent merchant feed import that still listed this offer: the last import of its merchant feed whose check for removed offers finished cleanly, or the import that last changed the offer, whichever is later. It is the age of the feed data, not a statement that the price is current.", "type": [ "string", "null" ] }, "source_network": { "description": "Affiliate network the feed came from, e.g. awin, cj, rakuten, tradedoubler.", "type": "string" }, "source_type": { "description": "How this offer entered the catalog. All offers come from affiliate network feeds.", "enum": [ "affiliate_feed" ], "type": "string" }, "source_updated_at": { "deprecated": true, "description": "DEPRECATED — alias of source_imported_at with the identical value, kept only for existing clients and removed 30 days after this server version went live. Read source_imported_at instead.", "type": [ "string", "null" ] }, "stock_status": { "description": "'unknown' means the feed did not state stock, not that the item is unavailable.", "enum": [ "in_stock", "unknown" ], "type": "string" }, "unit_price_text": { "description": "Unit price exactly as the merchant feed states it, e.g. '2,60 € / 1 ml' or '1 kg = 12,99 €'. Present only when the feed provides one. When present, show it next to the price; never calculate a unit price yourself.", "type": "string" }, "url": { "description": "Link to view and buy at this merchant. Show this to the user.", "type": "string" } }, "required": [ "pid", "merchant", "source_type", "source_network", "source_imported_at", "source_updated_at", "market", "price", "currency", "shipping", "stock_status", "match_tier", "url" ], "type": [ "object", "null" ] }, "brand": { "type": [ "string", "null" ] }, "grund": { "description": "One sentence of catalog facts behind the rang: publisher or brand, ISBN or GTIN, number of merchants in this market. Catalog facts, not Edwin's judgement.", "type": "string" }, "image_url": { "description": "Product image from the merchant, or null if the merchant supplies none. Show it with the product. If it is null, you may show an image of the same product from another source. Never label the product with a merchant other than the one named in best_offer. Omitted only if you pass a `fields` list without it.", "type": [ "string", "null" ] }, "match_score": { "description": "Raw merge confidence behind match_tier, 0–1.", "type": [ "number", "null" ] }, "match_tier": { "description": "How confidently merchant offers were merged into this catalog product.", "enum": [ "exact_gtin", "strong_identifier", "attribute_match", "fuzzy", "unclassified" ], "type": "string" }, "merchant_count": { "description": "Number of merchants with a current offer for this product in the user market.", "type": "integer" }, "name": { "type": "string" }, "pid": { "description": "Stable product id. Pass to other Edwin tools.", "type": "string" }, "price": { "description": "Lowest current offer price for this product in the market.", "properties": { "amount": { "type": "number" }, "currency": { "type": "string" }, "formatted": { "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "price_range": { "description": "Lowest and highest current offer price across the merchants in this market.", "properties": { "currency": { "type": "string" }, "max": { "type": "number" }, "min": { "type": "number" } }, "required": [ "min", "max", "currency" ], "type": "object" }, "rang": { "description": "Set by search_products. Says where the item came from, not how popular it is. 'anker': a catalog match for a name suggested for this request (by you in suggested_names, or by Edwin from general knowledge). 'entdeckung': another catalog match that passed the checks for its product type (a recognizable brand or publisher, and the fields that type requires).", "enum": [ "anker", "entdeckung" ], "type": "string" }, "source_imported_at": { "description": "ISO timestamp of the most recent merchant feed import that still listed an offer for this product in the market (same rule as source_imported_at on an offer). It is the age of the feed data, not a statement that the price is current.", "type": [ "string", "null" ] }, "source_updated_at": { "deprecated": true, "description": "DEPRECATED — alias of source_imported_at with the identical value, kept only for existing clients and removed 30 days after this server version went live. Read source_imported_at instead.", "type": [ "string", "null" ] }, "url": { "description": "Link to view and buy this product. Show this to the user.", "type": "string" } }, "required": [ "pid", "name", "price", "merchant_count", "availability", "url" ], "type": "object" }, "type": "array" }, "market": { "type": "string" }, "note": { "description": "Plain-language explanation for the user. Set whenever the result is empty, and also when something about a non-empty result needs saying — for example that the ranking did not run and the order is the raw catalog order.", "type": [ "string", "null" ] }, "reference": { "properties": { "name": { "type": "string" }, "pid": { "type": "string" } }, "required": [ "pid" ], "type": "object" } }, "required": [ "reference", "direction", "items", "market" ], "type": "object" } }, { "description": "Return the full list of current merchant offers for one product in a market: merchant, price, currency, stock status, source timestamp, match tier, and a purchase link, cheapest first. Use when the user wants to see every merchant for one product — search_products already carries the cheapest one.", "inputSchema": { "additionalProperties": false, "properties": { "include_description": { "default": false, "description": "Also return the merchant feed's product description and, for each listed offer, that merchant's own title and description, as plain text shortened to 1200 characters each. It is merchant copy, not a checked spec sheet. Leave it off unless the user asks what the product is like.", "type": "boolean" }, "limit": { "default": 8, "description": "How many offers to return, cheapest first.", "maximum": 8, "minimum": 1, "type": "integer" }, "market": { "description": "ISO 3166-1 alpha-2 country code of the user's shopping market, e.g. DE, AT, NL, FR, GB, US. Infer from the user's context.", "pattern": "^[A-Za-z]{2}$", "type": "string" }, "pid": { "description": "Product id exactly as returned by a previous Edwin tool result. Never invent one — call search_products first if you do not have a pid.", "type": "string" } }, "required": [ "pid", "market" ], "type": "object" }, "name": "get_offers", "outputSchema": { "properties": { "app_summaries": { "description": "Only for Edwin's app view: it can load short product summaries for these results. Ignore it; nothing to show or say.", "type": "boolean" }, "brand": { "type": [ "string", "null" ] }, "description": { "description": "Only with include_description: the merchant feed's product description, plain text, shortened. Null when the feed has none worth showing.", "type": [ "string", "null" ] }, "empty_reason": { "description": "Machine-readable reason for an empty result. restricted_category: matches existed but fall into a product category this connector does not serve. no_match_in_market: nothing matched in this market. no_offers_for_product: the product has no merchant offer here at all. no_fresh_offers_for_product: the product has offers, but none is confirmed by the most recent import of its source, so there is no up-to-date price — do not quote an older one. query_too_short: the query carried no searchable terms. market_not_covered: no offers in this market at all. unknown_pid: no product with that id — call search_products for a real one. no_substantial_match: products matched, but none had a recognizable brand or publisher and the fields required for the product type — say so; the user can explicitly ask for unbranded or self-published items.", "enum": [ "no_match_in_market", "no_offers_for_product", "no_fresh_offers_for_product", "query_too_short", "market_not_covered", "unknown_pid", "restricted_category", "no_substantial_match" ], "type": "string" }, "market": { "type": "string" }, "merchant_texts": { "description": "Only with include_description: the title and description each listed merchant sends for this product, plain text, shortened, duplicates removed, at most six.", "items": { "properties": { "description": { "type": [ "string", "null" ] }, "merchant": { "type": "string" }, "title": { "type": [ "string", "null" ] } }, "required": [ "merchant", "title", "description" ], "type": "object" }, "type": "array" }, "name": { "type": "string" }, "note": { "description": "Plain-language explanation for the user. Set whenever the result is empty, and also when something about a non-empty result needs saying — for example that the ranking did not run and the order is the raw catalog order.", "type": [ "string", "null" ] }, "offers": { "items": { "properties": { "currency": { "type": "string" }, "market": { "type": "string" }, "match_score": { "description": "Raw merge confidence behind match_tier, 0–1. Null when none is stored.", "type": [ "number", "null" ] }, "match_tier": { "description": "How confidently offers were merged into this catalog product: exact_gtin (GTIN match), strong_identifier (GTIN plus brand and MPN), attribute_match (brand and MPN), fuzzy (merchant item id only), unclassified (no confidence value stored). This is a product-level value, so every offer of one product carries the same tier.", "enum": [ "exact_gtin", "strong_identifier", "attribute_match", "fuzzy", "unclassified" ], "type": "string" }, "merchant": { "description": "Merchant name as delivered by the feed.", "type": "string" }, "pid": { "type": "string" }, "price": { "description": "Offer price in `currency`, as delivered by the feed.", "type": "number" }, "shipping": { "description": "Shipping cost. Always null: the merchant feeds behind this catalog do not carry shipping, so the price above is the item price alone — do not present it as a total.", "type": [ "number", "null" ] }, "source_imported_at": { "description": "ISO timestamp of the most recent merchant feed import that still listed this offer: the last import of its merchant feed whose check for removed offers finished cleanly, or the import that last changed the offer, whichever is later. It is the age of the feed data, not a statement that the price is current.", "type": [ "string", "null" ] }, "source_network": { "description": "Affiliate network the feed came from, e.g. awin, cj, rakuten, tradedoubler.", "type": "string" }, "source_type": { "description": "How this offer entered the catalog. All offers come from affiliate network feeds.", "enum": [ "affiliate_feed" ], "type": "string" }, "source_updated_at": { "deprecated": true, "description": "DEPRECATED — alias of source_imported_at with the identical value, kept only for existing clients and removed 30 days after this server version went live. Read source_imported_at instead.", "type": [ "string", "null" ] }, "stock_status": { "description": "'unknown' means the feed did not state stock, not that the item is unavailable.", "enum": [ "in_stock", "unknown" ], "type": "string" }, "unit_price_text": { "description": "Unit price exactly as the merchant feed states it, e.g. '2,60 € / 1 ml' or '1 kg = 12,99 €'. Present only when the feed provides one. When present, show it next to the price; never calculate a unit price yourself.", "type": "string" }, "url": { "description": "Link to view and buy at this merchant. Show this to the user.", "type": "string" } }, "required": [ "pid", "merchant", "source_type", "source_network", "source_imported_at", "source_updated_at", "market", "price", "currency", "shipping", "stock_status", "match_tier", "url" ], "type": "object" }, "type": "array" }, "pid": { "type": "string" } }, "required": [ "pid", "market", "offers" ], "type": "object" } }, { "description": "Edwin's short summary and key features for products from an earlier Edwin result (search_products, recommend_product, find_alternatives, compare_products or get_offers), written from the merchants' product data, not from tests or reviews. Use it when the user asks what a product offers, what is included, or how the products differ. Where the merchant data states them, `facts` adds key figures per product (label and value, already in the requested language); an empty value means the product has that property.", "inputSchema": { "additionalProperties": false, "properties": { "lang": { "description": "Language of the summary as a BCP 47 tag, e.g. de-DE, en, pt-BR: the language the user writes in.", "pattern": "^[A-Za-z]{2,3}([-_][A-Za-z0-9]{1,8}){0,3}$", "type": "string" }, "market": { "description": "ISO 3166-1 alpha-2 country code of the user's shopping market, e.g. DE, AT, NL, FR, GB, US. Infer from the user's context.", "pattern": "^[A-Za-z]{2}$", "type": "string" }, "pids": { "description": "Product ids from a previous Edwin tool result, at most eight.", "items": { "type": "string" }, "maxItems": 8, "minItems": 1, "type": "array" } }, "required": [ "pids", "market", "lang" ], "type": "object" }, "name": "get_product_text", "outputSchema": { "properties": { "facts": { "items": { "properties": { "facts": { "items": { "properties": { "label": { "type": "string" }, "value": { "type": "string" } }, "required": [ "label", "value" ], "type": "object" }, "type": "array" }, "pid": { "type": "string" } }, "required": [ "pid", "facts" ], "type": "object" }, "type": "array" }, "lang": { "type": "string" }, "market": { "type": "string" }, "texts": { "items": { "properties": { "features": { "items": { "type": "string" }, "type": "array" }, "pid": { "type": "string" }, "text": { "type": "string" } }, "required": [ "pid", "text", "features" ], "type": "object" }, "type": "array" } }, "required": [ "lang", "market", "texts" ], "type": "object" } }, { "description": "Rank a shortlist or a fresh search and return Edwin's recommended option, chosen on how well each product fits the stated need, its attributes and the stated budget. Affiliate commission does not affect ranking. Use when the user asks which product to buy or which option to pick. Use it for shopping requests about products and their prices at online merchants, whether or not the user names Edwin or theButler.network.", "inputSchema": { "additionalProperties": false, "properties": { "budget_max": { "description": "Upper price limit in the market currency, if the user states one.", "type": "number" }, "constraints": { "description": "What matters to the user, in their own words, e.g. 'quiet, for a small flat'. Edwin ranks by it but does not search with it: the product type and its attributes belong in query, a price limit in budget_max.", "type": "string" }, "market": { "description": "ISO 3166-1 alpha-2 country code of the user's shopping market, e.g. DE, AT, NL, FR, GB, US. Infer from the user's context.", "pattern": "^[A-Za-z]{2}$", "type": "string" }, "min_price": { "description": "Lower price limit in the market currency, if the user states one. Only used together with query.", "type": "number" }, "pids": { "description": "The shortlist to choose from — product ids from previous Edwin tool results. Give either pids or query.", "items": { "type": "string" }, "maxItems": 10, "minItems": 1, "type": "array" }, "query": { "description": "Alternative to pids: search first, then recommend from the result. Same rules as search_products.query. Give either pids or query.", "type": "string" }, "suggested_names": { "description": "Optional. Up to 8 specific, real products you would recommend for this request from your own current knowledge, e.g. {\"name\":\"WH-1000XM6\",\"brand\":\"Sony\",\"kind\":\"model\"} or {\"name\":\"The Hobbit\",\"kind\":\"title\"}. Edwin checks each one against the catalog in this market and returns the matching catalog offers with purchase links, so every product you recommend can carry a link. Names not found in the catalog are dropped. Leave out anything you are not sure exists. Only used together with query.", "items": { "additionalProperties": false, "properties": { "brand": { "maxLength": 40, "type": "string" }, "kind": { "enum": [ "model", "title", "series", "brand" ], "type": "string" }, "name": { "maxLength": 80, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }, "maxItems": 8, "type": "array" } }, "required": [ "market" ], "type": "object" }, "name": "recommend_product", "outputSchema": { "properties": { "alternatives": { "description": "The remaining candidates in ranked order.", "items": { "properties": { "availability": { "enum": [ "in_stock", "unknown" ], "type": "string" }, "badge": { "description": "Set on the one product Edwin's ranking picked, when a ranking ran.", "enum": [ "edwins_choice", null ], "type": [ "string", "null" ] }, "best_offer": { "description": "The cheapest current offer for this product in the market: which merchant, at what price, and the link. Same offer the `price` field is taken from. Call get_offers only when the user wants the full merchant list.", "properties": { "currency": { "type": "string" }, "market": { "type": "string" }, "match_score": { "description": "Raw merge confidence behind match_tier, 0–1. Null when none is stored.", "type": [ "number", "null" ] }, "match_tier": { "description": "How confidently offers were merged into this catalog product: exact_gtin (GTIN match), strong_identifier (GTIN plus brand and MPN), attribute_match (brand and MPN), fuzzy (merchant item id only), unclassified (no confidence value stored). This is a product-level value, so every offer of one product carries the same tier.", "enum": [ "exact_gtin", "strong_identifier", "attribute_match", "fuzzy", "unclassified" ], "type": "string" }, "merchant": { "description": "Merchant name as delivered by the feed.", "type": "string" }, "pid": { "type": "string" }, "price": { "description": "Offer price in `currency`, as delivered by the feed.", "type": "number" }, "shipping": { "description": "Shipping cost. Always null: the merchant feeds behind this catalog do not carry shipping, so the price above is the item price alone — do not present it as a total.", "type": [ "number", "null" ] }, "source_imported_at": { "description": "ISO timestamp of the most recent merchant feed import that still listed this offer: the last import of its merchant feed whose check for removed offers finished cleanly, or the import that last changed the offer, whichever is later. It is the age of the feed data, not a statement that the price is current.", "type": [ "string", "null" ] }, "source_network": { "description": "Affiliate network the feed came from, e.g. awin, cj, rakuten, tradedoubler.", "type": "string" }, "source_type": { "description": "How this offer entered the catalog. All offers come from affiliate network feeds.", "enum": [ "affiliate_feed" ], "type": "string" }, "source_updated_at": { "deprecated": true, "description": "DEPRECATED — alias of source_imported_at with the identical value, kept only for existing clients and removed 30 days after this server version went live. Read source_imported_at instead.", "type": [ "string", "null" ] }, "stock_status": { "description": "'unknown' means the feed did not state stock, not that the item is unavailable.", "enum": [ "in_stock", "unknown" ], "type": "string" }, "unit_price_text": { "description": "Unit price exactly as the merchant feed states it, e.g. '2,60 € / 1 ml' or '1 kg = 12,99 €'. Present only when the feed provides one. When present, show it next to the price; never calculate a unit price yourself.", "type": "string" }, "url": { "description": "Link to view and buy at this merchant. Show this to the user.", "type": "string" } }, "required": [ "pid", "merchant", "source_type", "source_network", "source_imported_at", "source_updated_at", "market", "price", "currency", "shipping", "stock_status", "match_tier", "url" ], "type": [ "object", "null" ] }, "brand": { "type": [ "string", "null" ] }, "grund": { "description": "One sentence of catalog facts behind the rang: publisher or brand, ISBN or GTIN, number of merchants in this market. Catalog facts, not Edwin's judgement.", "type": "string" }, "image_url": { "description": "Product image from the merchant, or null if the merchant supplies none. Show it with the product. If it is null, you may show an image of the same product from another source. Never label the product with a merchant other than the one named in best_offer. Omitted only if you pass a `fields` list without it.", "type": [ "string", "null" ] }, "match_score": { "description": "Raw merge confidence behind match_tier, 0–1.", "type": [ "number", "null" ] }, "match_tier": { "description": "How confidently merchant offers were merged into this catalog product.", "enum": [ "exact_gtin", "strong_identifier", "attribute_match", "fuzzy", "unclassified" ], "type": "string" }, "merchant_count": { "description": "Number of merchants with a current offer for this product in the user market.", "type": "integer" }, "name": { "type": "string" }, "pid": { "description": "Stable product id. Pass to other Edwin tools.", "type": "string" }, "price": { "description": "Lowest current offer price for this product in the market.", "properties": { "amount": { "type": "number" }, "currency": { "type": "string" }, "formatted": { "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "price_range": { "description": "Lowest and highest current offer price across the merchants in this market.", "properties": { "currency": { "type": "string" }, "max": { "type": "number" }, "min": { "type": "number" } }, "required": [ "min", "max", "currency" ], "type": "object" }, "rang": { "description": "Set by search_products. Says where the item came from, not how popular it is. 'anker': a catalog match for a name suggested for this request (by you in suggested_names, or by Edwin from general knowledge). 'entdeckung': another catalog match that passed the checks for its product type (a recognizable brand or publisher, and the fields that type requires).", "enum": [ "anker", "entdeckung" ], "type": "string" }, "source_imported_at": { "description": "ISO timestamp of the most recent merchant feed import that still listed an offer for this product in the market (same rule as source_imported_at on an offer). It is the age of the feed data, not a statement that the price is current.", "type": [ "string", "null" ] }, "source_updated_at": { "deprecated": true, "description": "DEPRECATED — alias of source_imported_at with the identical value, kept only for existing clients and removed 30 days after this server version went live. Read source_imported_at instead.", "type": [ "string", "null" ] }, "url": { "description": "Link to view and buy this product. Show this to the user.", "type": "string" } }, "required": [ "pid", "name", "price", "merchant_count", "availability", "url" ], "type": "object" }, "type": "array" }, "app_summaries": { "description": "Only for Edwin's app view: it can load short product summaries for these results. Ignore it; nothing to show or say.", "type": "boolean" }, "empty_reason": { "description": "Machine-readable reason for an empty result. restricted_category: matches existed but fall into a product category this connector does not serve. no_match_in_market: nothing matched in this market. no_offers_for_product: the product has no merchant offer here at all. no_fresh_offers_for_product: the product has offers, but none is confirmed by the most recent import of its source, so there is no up-to-date price — do not quote an older one. query_too_short: the query carried no searchable terms. market_not_covered: no offers in this market at all. unknown_pid: no product with that id — call search_products for a real one. no_substantial_match: products matched, but none had a recognizable brand or publisher and the fields required for the product type — say so; the user can explicitly ask for unbranded or self-published items.", "enum": [ "no_match_in_market", "no_offers_for_product", "no_fresh_offers_for_product", "query_too_short", "market_not_covered", "unknown_pid", "restricted_category", "no_substantial_match" ], "type": "string" }, "market": { "type": "string" }, "note": { "description": "Plain-language explanation for the user. Set whenever the result is empty, and also when something about a non-empty result needs saying — for example that the ranking did not run and the order is the raw catalog order.", "type": [ "string", "null" ] }, "ranked_by": { "description": "'catalog_order' means Edwin's ranking picked none of these items — it did not run, or it ran and chose none of them — and the order is the catalog's own: present it as a list, not as a recommendation.", "enum": [ "edwin_ranking", "catalog_order" ], "type": "string" }, "recommendation": { "properties": { "availability": { "enum": [ "in_stock", "unknown" ], "type": "string" }, "badge": { "description": "Set on the one product Edwin's ranking picked, when a ranking ran.", "enum": [ "edwins_choice", null ], "type": [ "string", "null" ] }, "best_offer": { "description": "The cheapest current offer for this product in the market: which merchant, at what price, and the link. Same offer the `price` field is taken from. Call get_offers only when the user wants the full merchant list.", "properties": { "currency": { "type": "string" }, "market": { "type": "string" }, "match_score": { "description": "Raw merge confidence behind match_tier, 0–1. Null when none is stored.", "type": [ "number", "null" ] }, "match_tier": { "description": "How confidently offers were merged into this catalog product: exact_gtin (GTIN match), strong_identifier (GTIN plus brand and MPN), attribute_match (brand and MPN), fuzzy (merchant item id only), unclassified (no confidence value stored). This is a product-level value, so every offer of one product carries the same tier.", "enum": [ "exact_gtin", "strong_identifier", "attribute_match", "fuzzy", "unclassified" ], "type": "string" }, "merchant": { "description": "Merchant name as delivered by the feed.", "type": "string" }, "pid": { "type": "string" }, "price": { "description": "Offer price in `currency`, as delivered by the feed.", "type": "number" }, "shipping": { "description": "Shipping cost. Always null: the merchant feeds behind this catalog do not carry shipping, so the price above is the item price alone — do not present it as a total.", "type": [ "number", "null" ] }, "source_imported_at": { "description": "ISO timestamp of the most recent merchant feed import that still listed this offer: the last import of its merchant feed whose check for removed offers finished cleanly, or the import that last changed the offer, whichever is later. It is the age of the feed data, not a statement that the price is current.", "type": [ "string", "null" ] }, "source_network": { "description": "Affiliate network the feed came from, e.g. awin, cj, rakuten, tradedoubler.", "type": "string" }, "source_type": { "description": "How this offer entered the catalog. All offers come from affiliate network feeds.", "enum": [ "affiliate_feed" ], "type": "string" }, "source_updated_at": { "deprecated": true, "description": "DEPRECATED — alias of source_imported_at with the identical value, kept only for existing clients and removed 30 days after this server version went live. Read source_imported_at instead.", "type": [ "string", "null" ] }, "stock_status": { "description": "'unknown' means the feed did not state stock, not that the item is unavailable.", "enum": [ "in_stock", "unknown" ], "type": "string" }, "unit_price_text": { "description": "Unit price exactly as the merchant feed states it, e.g. '2,60 € / 1 ml' or '1 kg = 12,99 €'. Present only when the feed provides one. When present, show it next to the price; never calculate a unit price yourself.", "type": "string" }, "url": { "description": "Link to view and buy at this merchant. Show this to the user.", "type": "string" } }, "required": [ "pid", "merchant", "source_type", "source_network", "source_imported_at", "source_updated_at", "market", "price", "currency", "shipping", "stock_status", "match_tier", "url" ], "type": [ "object", "null" ] }, "brand": { "type": [ "string", "null" ] }, "grund": { "description": "One sentence of catalog facts behind the rang: publisher or brand, ISBN or GTIN, number of merchants in this market. Catalog facts, not Edwin's judgement.", "type": "string" }, "image_url": { "description": "Product image from the merchant, or null if the merchant supplies none. Show it with the product. If it is null, you may show an image of the same product from another source. Never label the product with a merchant other than the one named in best_offer. Omitted only if you pass a `fields` list without it.", "type": [ "string", "null" ] }, "match_score": { "description": "Raw merge confidence behind match_tier, 0–1.", "type": [ "number", "null" ] }, "match_tier": { "description": "How confidently merchant offers were merged into this catalog product.", "enum": [ "exact_gtin", "strong_identifier", "attribute_match", "fuzzy", "unclassified" ], "type": "string" }, "merchant_count": { "description": "Number of merchants with a current offer for this product in the user market.", "type": "integer" }, "name": { "type": "string" }, "pid": { "description": "Stable product id. Pass to other Edwin tools.", "type": "string" }, "price": { "description": "Lowest current offer price for this product in the market.", "properties": { "amount": { "type": "number" }, "currency": { "type": "string" }, "formatted": { "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "price_range": { "description": "Lowest and highest current offer price across the merchants in this market.", "properties": { "currency": { "type": "string" }, "max": { "type": "number" }, "min": { "type": "number" } }, "required": [ "min", "max", "currency" ], "type": "object" }, "rang": { "description": "Set by search_products. Says where the item came from, not how popular it is. 'anker': a catalog match for a name suggested for this request (by you in suggested_names, or by Edwin from general knowledge). 'entdeckung': another catalog match that passed the checks for its product type (a recognizable brand or publisher, and the fields that type requires).", "enum": [ "anker", "entdeckung" ], "type": "string" }, "source_imported_at": { "description": "ISO timestamp of the most recent merchant feed import that still listed an offer for this product in the market (same rule as source_imported_at on an offer). It is the age of the feed data, not a statement that the price is current.", "type": [ "string", "null" ] }, "source_updated_at": { "deprecated": true, "description": "DEPRECATED — alias of source_imported_at with the identical value, kept only for existing clients and removed 30 days after this server version went live. Read source_imported_at instead.", "type": [ "string", "null" ] }, "url": { "description": "Link to view and buy this product. Show this to the user.", "type": "string" } }, "required": [ "pid", "name", "price", "merchant_count", "availability", "url" ], "type": [ "object", "null" ] } }, "required": [ "recommendation", "alternatives", "ranked_by", "market" ], "type": "object" } }, { "description": "Find purchasable product matches across merchants in a specified market. Use when the user wants to find or buy something: a need, a category, a budget, a gift idea, the best product of a kind, or the price of a named product. Returns normalized product entities with merchant count, price range and the cheapest current offer per product, each with a link. Each product carries a rang that says whether it matches a name suggested for the request (by you or by Edwin) or is another catalog match. Call get_offers only when the user wants the full merchant list for one product. Queries may be in any language. Use it for shopping requests about products and their prices at online merchants, whether or not the user names Edwin or theButler.network.", "inputSchema": { "additionalProperties": false, "properties": { "budget_max": { "description": "Upper price limit in the market currency, if the user states one.", "type": "number" }, "fields": { "description": "Restrict the returned product fields to these. `pid`, and on search results `rang` and `grund`, are always included. Leave this out to get the full item including its image — only pass a list if you deliberately want fewer fields.", "items": { "enum": [ "pid", "name", "brand", "image_url", "price", "price_range", "merchant_count", "availability", "source_imported_at", "match_tier", "match_score", "badge", "url", "source_updated_at", "best_offer" ], "type": "string" }, "type": "array" }, "limit": { "default": 8, "description": "How many products to return.", "maximum": 10, "minimum": 1, "type": "integer" }, "market": { "description": "ISO 3166-1 alpha-2 country code of the user's shopping market, e.g. DE, AT, NL, FR, GB, US. Infer from the user's context.", "pattern": "^[A-Za-z]{2}$", "type": "string" }, "min_price": { "description": "Lower price limit in the market currency, if the user states one.", "type": "number" }, "query": { "description": "The product the user is looking for: product type plus key attributes (size, colour, use case). Write the product-type word in the language of the market's merchants, even when the user writes in another language: German for DE, AT and CH ('fernseher 65 zoll oled', not 'tv' or 'television'), Dutch for NL, French for FR, English for GB and US. Catalog titles are in the merchants' language, so a product-type word in another language finds few or wrong products. Keep brand and model names exactly as the user wrote them.", "type": "string" }, "suggested_names": { "description": "Optional. Up to 8 specific, real products you would recommend for this request from your own current knowledge, e.g. {\"name\":\"WH-1000XM6\",\"brand\":\"Sony\",\"kind\":\"model\"} or {\"name\":\"The Hobbit\",\"kind\":\"title\"}. Edwin checks each one against the catalog in this market and returns the matching catalog offers with purchase links, so every product you recommend can carry a link. Names not found in the catalog are dropped. Leave out anything you are not sure exists.", "items": { "additionalProperties": false, "properties": { "brand": { "maxLength": 40, "type": "string" }, "kind": { "enum": [ "model", "title", "series", "brand" ], "type": "string" }, "name": { "maxLength": 80, "minLength": 1, "type": "string" } }, "required": [ "name" ], "type": "object" }, "maxItems": 8, "type": "array" } }, "required": [ "query", "market" ], "type": "object" }, "name": "search_products", "outputSchema": { "properties": { "app_summaries": { "description": "Only for Edwin's app view: it can load short product summaries for these results. Ignore it; nothing to show or say.", "type": "boolean" }, "empty_reason": { "description": "Machine-readable reason for an empty result. restricted_category: matches existed but fall into a product category this connector does not serve. no_match_in_market: nothing matched in this market. no_offers_for_product: the product has no merchant offer here at all. no_fresh_offers_for_product: the product has offers, but none is confirmed by the most recent import of its source, so there is no up-to-date price — do not quote an older one. query_too_short: the query carried no searchable terms. market_not_covered: no offers in this market at all. unknown_pid: no product with that id — call search_products for a real one. no_substantial_match: products matched, but none had a recognizable brand or publisher and the fields required for the product type — say so; the user can explicitly ask for unbranded or self-published items.", "enum": [ "no_match_in_market", "no_offers_for_product", "no_fresh_offers_for_product", "query_too_short", "market_not_covered", "unknown_pid", "restricted_category", "no_substantial_match" ], "type": "string" }, "items": { "items": { "properties": { "availability": { "enum": [ "in_stock", "unknown" ], "type": "string" }, "badge": { "description": "Set on the one product Edwin's ranking picked, when a ranking ran.", "enum": [ "edwins_choice", null ], "type": [ "string", "null" ] }, "best_offer": { "description": "The cheapest current offer for this product in the market: which merchant, at what price, and the link. Same offer the `price` field is taken from. Call get_offers only when the user wants the full merchant list.", "properties": { "currency": { "type": "string" }, "market": { "type": "string" }, "match_score": { "description": "Raw merge confidence behind match_tier, 0–1. Null when none is stored.", "type": [ "number", "null" ] }, "match_tier": { "description": "How confidently offers were merged into this catalog product: exact_gtin (GTIN match), strong_identifier (GTIN plus brand and MPN), attribute_match (brand and MPN), fuzzy (merchant item id only), unclassified (no confidence value stored). This is a product-level value, so every offer of one product carries the same tier.", "enum": [ "exact_gtin", "strong_identifier", "attribute_match", "fuzzy", "unclassified" ], "type": "string" }, "merchant": { "description": "Merchant name as delivered by the feed.", "type": "string" }, "pid": { "type": "string" }, "price": { "description": "Offer price in `currency`, as delivered by the feed.", "type": "number" }, "shipping": { "description": "Shipping cost. Always null: the merchant feeds behind this catalog do not carry shipping, so the price above is the item price alone — do not present it as a total.", "type": [ "number", "null" ] }, "source_imported_at": { "description": "ISO timestamp of the most recent merchant feed import that still listed this offer: the last import of its merchant feed whose check for removed offers finished cleanly, or the import that last changed the offer, whichever is later. It is the age of the feed data, not a statement that the price is current.", "type": [ "string", "null" ] }, "source_network": { "description": "Affiliate network the feed came from, e.g. awin, cj, rakuten, tradedoubler.", "type": "string" }, "source_type": { "description": "How this offer entered the catalog. All offers come from affiliate network feeds.", "enum": [ "affiliate_feed" ], "type": "string" }, "source_updated_at": { "deprecated": true, "description": "DEPRECATED — alias of source_imported_at with the identical value, kept only for existing clients and removed 30 days after this server version went live. Read source_imported_at instead.", "type": [ "string", "null" ] }, "stock_status": { "description": "'unknown' means the feed did not state stock, not that the item is unavailable.", "enum": [ "in_stock", "unknown" ], "type": "string" }, "unit_price_text": { "description": "Unit price exactly as the merchant feed states it, e.g. '2,60 € / 1 ml' or '1 kg = 12,99 €'. Present only when the feed provides one. When present, show it next to the price; never calculate a unit price yourself.", "type": "string" }, "url": { "description": "Link to view and buy at this merchant. Show this to the user.", "type": "string" } }, "required": [ "pid", "merchant", "source_type", "source_network", "source_imported_at", "source_updated_at", "market", "price", "currency", "shipping", "stock_status", "match_tier", "url" ], "type": [ "object", "null" ] }, "brand": { "type": [ "string", "null" ] }, "grund": { "description": "One sentence of catalog facts behind the rang: publisher or brand, ISBN or GTIN, number of merchants in this market. Catalog facts, not Edwin's judgement.", "type": "string" }, "image_url": { "description": "Product image from the merchant, or null if the merchant supplies none. Show it with the product. If it is null, you may show an image of the same product from another source. Never label the product with a merchant other than the one named in best_offer. Omitted only if you pass a `fields` list without it.", "type": [ "string", "null" ] }, "match_score": { "description": "Raw merge confidence behind match_tier, 0–1.", "type": [ "number", "null" ] }, "match_tier": { "description": "How confidently merchant offers were merged into this catalog product.", "enum": [ "exact_gtin", "strong_identifier", "attribute_match", "fuzzy", "unclassified" ], "type": "string" }, "merchant_count": { "description": "Number of merchants with a current offer for this product in the user market.", "type": "integer" }, "name": { "type": "string" }, "pid": { "description": "Stable product id. Pass to other Edwin tools.", "type": "string" }, "price": { "description": "Lowest current offer price for this product in the market.", "properties": { "amount": { "type": "number" }, "currency": { "type": "string" }, "formatted": { "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "price_range": { "description": "Lowest and highest current offer price across the merchants in this market.", "properties": { "currency": { "type": "string" }, "max": { "type": "number" }, "min": { "type": "number" } }, "required": [ "min", "max", "currency" ], "type": "object" }, "rang": { "description": "Set by search_products. Says where the item came from, not how popular it is. 'anker': a catalog match for a name suggested for this request (by you in suggested_names, or by Edwin from general knowledge). 'entdeckung': another catalog match that passed the checks for its product type (a recognizable brand or publisher, and the fields that type requires).", "enum": [ "anker", "entdeckung" ], "type": "string" }, "source_imported_at": { "description": "ISO timestamp of the most recent merchant feed import that still listed an offer for this product in the market (same rule as source_imported_at on an offer). It is the age of the feed data, not a statement that the price is current.", "type": [ "string", "null" ] }, "source_updated_at": { "deprecated": true, "description": "DEPRECATED — alias of source_imported_at with the identical value, kept only for existing clients and removed 30 days after this server version went live. Read source_imported_at instead.", "type": [ "string", "null" ] }, "url": { "description": "Link to view and buy this product. Show this to the user.", "type": "string" } }, "required": [ "pid", "name", "price", "merchant_count", "availability", "url" ], "type": "object" }, "type": "array" }, "market": { "description": "Canonical market the results are priced for.", "type": "string" }, "mischung": { "description": "How to present the ranks, read from the query: 'anker_vorne' when the user compared with something familiar, 'entdeckung_vorne' when they asked for something less obvious, 'beide' otherwise. The item order is Edwin's ranking when a ranking ran (see note). Absent when no suggested names were looked up for this call.", "enum": [ "anker_vorne", "beide", "entdeckung_vorne" ], "type": "string" }, "note": { "description": "Plain-language explanation for the user. Set whenever the result is empty, and also when something about a non-empty result needs saying — for example that the ranking did not run and the order is the raw catalog order.", "type": [ "string", "null" ] }, "wenig_auswahl": { "description": "True when fewer than three products passed the checks for their product type among the matches checked (the note says whether that was all matches or only part). Say that the selection is small instead of padding the answer. Absent when part of the search did not answer in time.", "type": "boolean" } }, "required": [ "items", "market" ], "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:992488b8c78a64e913733eef8a997cd41c2e189dd98ce09cd58a049197be3860 | sha256sum