US return policies, price-match rules, discounts, deals and Amazon price verdicts. Read-only.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
What Thrifle is, what each database covers and how big it is, how to cite it, and which tool answers which kind of question.
This tool takes no arguments.
What Thrifle is, what each database covers and how big it is, how to cite it, and which tool answers which kind of question.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Matches a product name (and optional brand) against recent U.S. CPSC recalls using a strict matcher tuned for zero false positives. Returns matching recalls with hazard and remedy, or an empty list. Useful before recommending a product.
| Argument | Type | Description |
|---|---|---|
| brand | string | |
| product* | string | Product title as sold, e.g. 'Peloton Tread+ treadmill' |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"product"
],
"properties": {
"brand": {
"type": "string",
"maxLength": 80
},
"product": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Product title as sold, e.g. 'Peloton Tread+ treadmill'"
}
},
"additionalProperties": false
}Side-by-side comparison of two US retailers' return policies with grades, per-axis winners (return window, cost to return, restocking fee, exclusions, holiday extension, transparency) and an overall winner. Use for 'is it easier to return to X or Y' questions.
| Argument | Type | Description |
|---|---|---|
| merchant_a* | string | Retailer name or thrifle.com slug — first retailer, e.g. "Costco", "best-buy", "Nordstrom" |
| merchant_b* | string | Retailer name or thrifle.com slug — second retailer, e.g. "Costco", "best-buy", "Nordstrom" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchant_a",
"merchant_b"
],
"properties": {
"merchant_a": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Retailer name or thrifle.com slug — first retailer, e.g. \"Costco\", \"best-buy\", \"Nordstrom\""
},
"merchant_b": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Retailer name or thrifle.com slug — second retailer, e.g. \"Costco\", \"best-buy\", \"Nordstrom\""
}
},
"additionalProperties": false
}What a US restaurant or retailer gives away for your birthday, whether it is actually free or needs a purchase or prior spend, how to sign up and how far ahead, the validity window, ID requirements, and known gotchas. Call for 'what does X give you on your birthday' questions.
| Argument | Type | Description |
|---|---|---|
| merchant* | string | Retailer name or thrifle.com slug — brand, e.g. 'Starbucks', 'Sephora', e.g. "Costco", "best-buy", "Nordstrom" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchant"
],
"properties": {
"merchant": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Retailer name or thrifle.com slug — brand, e.g. 'Starbucks', 'Sephora', e.g. \"Costco\", \"best-buy\", \"Nordstrom\""
}
},
"additionalProperties": false
}The full text of one Thrifle article by URL or slug (HTML stripped, long posts truncated at ~20,000 characters), plus its FAQ, author, date and URL for citation.
| Argument | Type | Description |
|---|---|---|
| post* | string | thrifle.com article URL or its slug |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"post"
],
"properties": {
"post": {
"type": "string",
"maxLength": 300,
"minLength": 3,
"description": "thrifle.com article URL or its slug"
}
},
"additionalProperties": false
}Step-by-step guide to cancelling a US subscription or membership: available channels (online, app, phone, in person), notice period, fees, refund after cancelling, retention tactics to expect, and an ease-of-cancellation grade. Coverage is still small; the response lists what is available when the merchant is not found.
| Argument | Type | Description |
|---|---|---|
| merchant* | string | Retailer name or thrifle.com slug — the service, e.g. 'Planet Fitness', e.g. "Costco", "best-buy", "Nordstrom" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchant"
],
"properties": {
"merchant": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Retailer name or thrifle.com slug — the service, e.g. 'Planet Fitness', e.g. \"Costco\", \"best-buy\", \"Nordstrom\""
}
},
"additionalProperties": false
}Full record for one card by its card_key (from search_credit_cards): APR tiers, intro and penalty APRs, fees, promotional financing terms with the issuer's own fine-print quote, rewards, perks, welcome offer, and provenance (pricing-terms URL, verification date, confidence). Store cards link to the partner retailer's return policy.
| Argument | Type | Description |
|---|---|---|
| card_key* | string | card_key from search_credit_cards, e.g. 'amazon-store-card' |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"card_key"
],
"properties": {
"card_key": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "card_key from search_credit_cards, e.g. 'amazon-store-card'"
}
},
"additionalProperties": false
}Everything Thrifle knows about one deal, by its thrifle.com URL or slug: price and list price, merchant, coupon, why it's great, the editorial verdict, the price-history verdict for Amazon items, FAQ, and the buy link. Use after search_deals when the shopper wants detail on one item.
| Argument | Type | Description |
|---|---|---|
| deal* | string | thrifle.com deal URL or the slug at the end of it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"deal"
],
"properties": {
"deal": {
"type": "string",
"maxLength": 300,
"minLength": 3,
"description": "thrifle.com deal URL or the slug at the end of it"
}
},
"additionalProperties": false
}Thrifle's editor-picked deal of the day with price, merchant and buy link. Cheap to call; returns found:false when none is set.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Verified military (active duty, veterans, reserve) and student discount programmes for a US retailer: value, eligibility, verification method (e.g. ID.me, SheerID), online vs in-store, stackability, exclusions, whether it is running right now, and the source URL. Call for 'does X have a military/student discount' questions.
| Argument | Type | Description |
|---|---|---|
| merchant* | string | Retailer name or thrifle.com slug, e.g. "Costco", "best-buy", "Nordstrom" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchant"
],
"properties": {
"merchant": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Retailer name or thrifle.com slug, e.g. \"Costco\", \"best-buy\", \"Nordstrom\""
}
},
"additionalProperties": false
}Current US macro numbers from Thrifle's Money Monitor: GDP growth, personal saving rate, average credit-card APR, revolving and total consumer credit, the federal debt, and mortgage / fed funds / 10-year Treasury rates, each with the previous reading and year-ago value. Sourced from FRED and the U.S. Treasury; refreshed daily.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Whether a US retailer matches competitors' prices (which competitors, proof required, exclusions, how to claim) and whether it offers a post-purchase price adjustment (window in days). Call for 'does X price match' or 'will X refund the difference if the price drops' questions.
| Argument | Type | Description |
|---|---|---|
| merchant* | string | Retailer name or thrifle.com slug, e.g. "Costco", "best-buy", "Nordstrom" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchant"
],
"properties": {
"merchant": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Retailer name or thrifle.com slug, e.g. \"Costco\", \"best-buy\", \"Nordstrom\""
}
},
"additionalProperties": false
}Latest US Consumer Price Index by spending category (headline, food, energy, shelter, apparel, etc.) with month-over-month and year-over-year change, plus average gas prices by grade with week-ago and year-ago comparisons. Sourced from BLS and EIA.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Verified return policy for a US retailer: return window, free returns, restocking fee, holiday extension, non-returnable items, an A+–D− grade, how it compares with its category, and the retailer's own policy URL. Optionally pass what the shopper bought to surface a product-specific exception (e.g. electronics at Costco). Call this for any 'what is X's return policy' question.
| Argument | Type | Description |
|---|---|---|
| product | string | Optional: the product being returned, e.g. 'MacBook Air' or 'gift card', to check for a category exception |
| merchant* | string | Retailer name or thrifle.com slug, e.g. "Costco", "best-buy", "Nordstrom" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchant"
],
"properties": {
"product": {
"type": "string",
"maxLength": 200,
"description": "Optional: the product being returned, e.g. 'MacBook Air' or 'gift card', to check for a category exception"
},
"merchant": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Retailer name or thrifle.com slug, e.g. \"Costco\", \"best-buy\", \"Nordstrom\""
}
},
"additionalProperties": false
}The store and co-branded credit cards a US retailer offers, with APR, annual fee, whether promotional financing is deferred interest, and links to each card's full terms, the retailer's store-card page and its return policy. Call for 'is the X store card worth it' or 'does X card have deferred interest' questions.
| Argument | Type | Description |
|---|---|---|
| merchant* | string | Retailer name or thrifle.com slug — e.g. 'Lowe's', 'Amazon', 'Best Buy', e.g. "Costco", "best-buy", "Nordstrom" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchant"
],
"properties": {
"merchant": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Retailer name or thrifle.com slug — e.g. 'Lowe's', 'Amazon', 'Best Buy', e.g. \"Costco\", \"best-buy\", \"Nordstrom\""
}
},
"additionalProperties": false
}A retailer's store page on Thrifle: how many live deals it has, the most recent ones with prices and buy links, and its military/student discount summary when known. Use for 'what deals does Costco have right now' questions.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (default 8, max 8) |
| merchant* | string | Retailer name or thrifle.com slug, e.g. "Costco", "best-buy", "Nordstrom" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchant"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 8,
"minimum": 1,
"description": "Max results (default 8, max 8)"
},
"merchant": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Retailer name or thrifle.com slug, e.g. \"Costco\", \"best-buy\", \"Nordstrom\""
}
},
"additionalProperties": false
}Retired in September 2026. Thrifle no longer provides price information for Amazon products; this tool always returns found:false with retired:true. Kept only so existing integrations do not break.
| Argument | Type | Description |
|---|---|---|
| asin_or_url* | string | 10-character ASIN (e.g. B0CHX3QBCH) or any Amazon product URL |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"asin_or_url"
],
"properties": {
"asin_or_url": {
"type": "string",
"maxLength": 500,
"minLength": 5,
"description": "10-character ASIN (e.g. B0CHX3QBCH) or any Amazon product URL"
}
},
"additionalProperties": false
}Browse verified birthday offers from US brands. Filters: actually_free (no purchase and no prior spend required), kids (child-eligible), no_signup, category (e.g. 'Restaurant', 'Beauty'), name fragment. Returns slim rows; use get_birthday_freebie for the full terms of one brand.
| Argument | Type | Description |
|---|---|---|
| kids | boolean | |
| limit | integer | Max results (default 15, max 50) |
| query | string | |
| category | string | |
| no_signup | boolean | |
| actually_free | boolean | Only offers with no purchase or prior-spend requirement |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"kids": {
"type": "boolean"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max results (default 15, max 50)"
},
"query": {
"type": "string",
"maxLength": 80
},
"category": {
"type": "string",
"maxLength": 60
},
"no_signup": {
"type": "boolean"
},
"actually_free": {
"type": "boolean",
"description": "Only offers with no purchase or prior-spend requirement"
}
},
"additionalProperties": false
}Find Thrifle articles by keyword: original data studies (e.g. what actually dropped on Black Friday, Prime Day fact-checks), buying guides, and the Money section's credit and BNPL explainers. Returns title, one-line summary, date, author and URL. Use get_blog_post to read one.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (default 8, max 20) |
| query* | string | |
| section | string | Default all |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Max results (default 8, max 20)"
},
"query": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"section": {
"enum": [
"all",
"shopping",
"money"
],
"type": "string",
"description": "Default all"
}
},
"additionalProperties": false
}Browse Thrifle's US credit-card database (store and co-branded cards first): filter by issuer, retailer, store cards only, or cards that use deferred-interest promotional financing. Rows carry purchase APR range, annual fee, financing type, data confidence and the verification date. Numbers come from issuer pricing pages, never roundups.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (default 20, max 60) |
| query | string | Name fragment matched against card name, issuer or partner retailer |
| issuer | string | Exact issuer name, e.g. 'Synchrony Bank', 'Citi Retail Services' |
| merchant | string | Partner retailer, e.g. 'Amazon', 'Lowe's' |
| store_cards_only | boolean | |
| deferred_interest_only | boolean | Only cards whose promo financing is deferred interest (retroactive interest if not paid in full) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 60,
"minimum": 1,
"description": "Max results (default 20, max 60)"
},
"query": {
"type": "string",
"maxLength": 80,
"description": "Name fragment matched against card name, issuer or partner retailer"
},
"issuer": {
"type": "string",
"maxLength": 80,
"description": "Exact issuer name, e.g. 'Synchrony Bank', 'Citi Retail Services'"
},
"merchant": {
"type": "string",
"maxLength": 80,
"description": "Partner retailer, e.g. 'Amazon', 'Lowe's'"
},
"store_cards_only": {
"type": "boolean"
},
"deferred_interest_only": {
"type": "boolean",
"description": "Only cards whose promo financing is deferred interest (retroactive interest if not paid in full)"
}
},
"additionalProperties": false
}Search Thrifle's curated US deals by product, brand or keyword. Returns live deals with price, list price, discount %, merchant, coupon code when there is one, the thrifle.com deal page, and a buy link. Expired deals are excluded unless include_expired is set. Use for 'is there a deal on X' or 'best price on X right now' questions.
| Argument | Type | Description |
|---|---|---|
| sort | string | Default newest |
| limit | integer | Max results (default 8, max 20) |
| query* | string | Product, brand or keyword, e.g. 'AirPods Pro', 'Dyson', 'robot vacuum' |
| include_expired | boolean |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"sort": {
"enum": [
"newest",
"popular"
],
"type": "string",
"description": "Default newest"
},
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Max results (default 8, max 20)"
},
"query": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "Product, brand or keyword, e.g. 'AirPods Pro', 'Dyson', 'robot vacuum'"
},
"include_expired": {
"type": "boolean"
}
},
"additionalProperties": false
}Browse Thrifle's discount database: filter by programme type (military, student, or both), retail category, and/or a name fragment. Returns slim rows with the discount value and a link per retailer.
| Argument | Type | Description |
|---|---|---|
| type | string | Only retailers with this programme |
| limit | integer | Max results (default 15, max 50) |
| query | string | Name fragment, e.g. 'nike' |
| category | string | Retail category, e.g. 'Apparel', 'Electronics' |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"type": {
"enum": [
"military",
"student",
"both"
],
"type": "string",
"description": "Only retailers with this programme"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max results (default 15, max 50)"
},
"query": {
"type": "string",
"maxLength": 80,
"description": "Name fragment, e.g. 'nike'"
},
"category": {
"type": "string",
"maxLength": 60,
"description": "Retail category, e.g. 'Apparel', 'Electronics'"
}
},
"additionalProperties": false
}Find retailers in Thrifle's return-policy database by name fragment and/or category (e.g. 'Fashion', 'Electronics', 'Home'). Returns slim rows with the return window and a link. With no arguments it returns the category list and total count. Use it when get_return_policy says a retailer was not found, or to list retailers in a category.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (default 10, max 25) |
| query | string | Name fragment, e.g. 'best' matches Best Buy |
| category | string | Category name as shown on thrifle.com/return-policy |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Max results (default 10, max 25)"
},
"query": {
"type": "string",
"maxLength": 80,
"description": "Name fragment, e.g. 'best' matches Best Buy"
},
"category": {
"type": "string",
"maxLength": 60,
"description": "Category name as shown on thrifle.com/return-policy"
}
},
"additionalProperties": false
}Reverse lookup: the US retailers whose price-match policy explicitly names the given store as an accepted competitor. Optionally filter by the product category being bought so only stores that plausibly stock it are listed. Use for 'who will match Amazon's price on this' questions.
| Argument | Type | Description |
|---|---|---|
| category | string | Optional deal category, e.g. 'Tech & Electronics', 'Home & Furniture', 'Toys & Hobbies' |
| merchant* | string | Retailer name or thrifle.com slug — the store whose price you found, e.g. "Costco", "best-buy", "Nordstrom" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchant"
],
"properties": {
"category": {
"type": "string",
"maxLength": 60,
"description": "Optional deal category, e.g. 'Tech & Electronics', 'Home & Furniture', 'Toys & Hobbies'"
},
"merchant": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Retailer name or thrifle.com slug — the store whose price you found, e.g. \"Costco\", \"best-buy\", \"Nordstrom\""
}
},
"additionalProperties": false
}