Thrifle

com.thrifle由 thrifle.com 發布官方發布者v1.0.0更新於 Oct 24, 2026

US return policies, price-match rules, discounts, deals and Amazon price verdicts. Read-only.

已驗證Streamable HTTP可網頁執行金融商業與電商

概覽

AI 產生的概覽

Thrifle 是一個唯讀的遠端 MCP 伺服器,為助理提供美國購物資料:退貨政策、比價規則、折扣、優惠、信用卡條款等。

可以做什麼
查詢並比較美國零售商的退貨政策,包含評級與特定商品的例外,也可依名稱或品類搜尋政策資料庫。查詢比價與購後補差價規則,並反查哪些零售商把某家店列為可比價對象。取得軍人、學生折扣方案、生日贈禮以及逐步取消訂閱指南。搜尋精選優惠、優惠詳情、每日優惠和某家零售商的在售優惠。瀏覽信用卡紀錄和商店聯名卡,讀取美國總體與 CPI 資料及平均油價。查詢近期 CPSC 產品召回,並搜尋或閱讀 Thrifle 部落格文章。
適用情境
適合回答美國購物相關問題:退貨是否方便、某店是否對競爭對手比價、有哪些折扣或生日優惠、某個優惠是否仍有效、商店信用卡的分期條款如何,或某產品是否被召回。每則回答都會連結回來源頁面。
執行需求
遠端 Streamable HTTP 端點,無需驗證、註冊或 API 金鑰。README 也說明可用 Node.js 和 npm 在本機執行同一套程式碼,並提供選用的 API 位址、速率限制和繞過金鑰環境變數。免費使用限制為每個位址每分鐘 60 次、每天 1,500 次呼叫。
安裝前請注意
工具為唯讀,沒有寫入路徑。優惠的購買連結是 thrifle.com 轉址連結,可能是聯盟行銷連結,因此推薦可能帶有商業利益。大量或商業用途需要付費授權。部分涵蓋有限:取消指南被說明為涵蓋仍少,亞馬遜價格預測工具已停用並一律回傳無結果。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Thrifle,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.thrifle%2Fmcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "thrifle": {
      "type": "http",
      "url": "https://api.thrifle.com/api/mcp"
    }
  }
}

README

Thrifle MCP server

US return policies, price-match rules, discounts, deals, credit-card terms and Amazon buy-or-wait verdicts — as read-only tools for Claude, ChatGPT, Cursor and any MCP client.

https://api.thrifle.com/api/mcp

No auth. No signup. 24 tools. Every answer links to the thrifle.com page it comes from.

[Install in VS Code] [Add to Cursor] [Docs] [Tests]

What you can ask

ToolExample
get_return_policyWhat is Costco's return policy on a laptop?
compare_return_policiesIs it easier to return to Target or Walmart?
search_return_policiesWhich furniture stores offer free returns?
get_price_match_policyDoes Best Buy price match Amazon?
who_will_price_matchWho will match this Amazon price on a TV?
get_merchant_discounts · search_discountsDoes Home Depot have a military discount?
get_cancellation_guideHow do I cancel Planet Fitness?
get_birthday_freebie · search_birthday_freebiesWhat does Starbucks give you on your birthday?
search_deals · get_deal · get_deal_of_the_day · get_store_dealsIs there a deal on AirPods Pro right now?
predict_amazon_priceShould I buy this Amazon product now or wait?
search_credit_cards · get_credit_card · get_store_credit_cardsDoes the Lowe's card use deferred interest?
get_money_monitor · get_price_pulseWhat is the average credit-card APR right now?
check_product_recallsHas this product been recalled?
about_thrifleWhat is Thrifle and what does it cover?

The data behind these tools: a return-policy database covering 2,250 US retailers with an A+–D− grade computed from the policy's own terms, price-match and price-adjustment policies, military/student discount programmes, birthday offers, cancellation guides, a curated deal feed, a credit-card database built from issuer pricing pages, and price history for hundreds of thousands of Amazon products. All of it is editor-verified and every record carries a last_verified date.

Connect it

Claude.ai / Claude Desktop (every plan; Free allows one custom connector) Settings → Connectors → Add custom connector → paste the URL → leave authentication empty.

Claude Code

sh
claude mcp add --transport http thrifle https://api.thrifle.com/api/mcp

ChatGPT — Settings → Apps & Connectors → Create (developer mode) → paste the URL, no authentication.

Cursor — click the badge above, or add to ~/.cursor/mcp.json:

json
{ "mcpServers": { "thrifle": { "url": "https://api.thrifle.com/api/mcp" } } }

VS Code — click the badge above, or code --add-mcp '{"name":"thrifle","type":"http","url":"https://api.thrifle.com/api/mcp"}'.

Perplexity (+ Custom connector → Remote), Grok (grok.com/connectors → Custom), Mistral Le Chat (Connectors → Custom MCP Connector), Gemini CLI (httpUrl under mcpServers), Gemini Enterprise (Manage team → Connected apps → Add MCP Server) all accept the same URL.

Claude Code plugin — this repo is also a Claude Code plugin (.claude-plugin/plugin.json, .mcp.json, and a thrifle-shopping skill that teaches the model which tool answers which question).

Try it from a terminal

sh
curl -s https://api.thrifle.com/api/mcp | jq .tools
curl -s -X POST https://api.thrifle.com/api/mcp \  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_return_policy","arguments":{"merchant":"Costco"}}}'

Run it yourself

sh
git clone https://github.com/ejazmu/thrifle-mcp && cd thrifle-mcpnpm installnpm start          # http://127.0.0.1:8787/mcp, reading Thrifle's public APInpm test           # 17 protocol + shaping fixtures, no network needed

This is the same code that serves api.thrifle.com/api/mcp. THRIFLE_API_BASE points it at a different API base; MCP_RATE_PER_MIN / MCP_RATE_PER_DAY set the per-IP limits; MCP_API_KEYS (comma-separated) lists keys that bypass them via Authorization: Bearer.

How it is built

  • Stateless Streamable HTTP. One McpServer + transport per request, JSON responses, no sessions — nothing to resume, nothing shared between callers, nothing for a CDN to buffer. GET on the endpoint returns a human-readable discovery document.
  • Tools call Thrifle's public REST API, never a database. That keeps the MCP answer identical to the website's answer: affiliate-link handling, expired-deal rules and serve-time grading all apply automatically. src/api-client.js is a 60-line loopback fetch.
  • Shapers, not raw payloads. src/shape.js turns each API response into the facts plus the canonical thrifle.com url and a cite block, and drops internal fields. Pure functions, all covered by fixtures.
  • Read-only by construction. Every tool declares readOnlyHint: true; the catalogue in src/tools.js has no write path.
  • Price verdicts never trigger a live fetch — they read the tracked-price database only.

Fair use and licensing

Free for assistants answering a person's question: 60 calls a minute and 1,500 a day per address. Bulk or commercial use is licensed — see thrifle.com/data-licensing; a licence comes with a key that lifts the limits. Deal buy_url values are thrifle.com redirects and may be affiliate links.

Links

Docs: https://thrifle.com/mcp · Return-policy database: https://thrifle.com/return-policy · Price Predict: https://thrifle.com/price-predict · Money: https://thrifle.com/money · Contact: [email protected]

MIT licensed. © 2026 Thrifle Technologies LLC.

來源:README.md,提交 a3b22c9

工具

24

get_return_policy

Get a retailer's return policy

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.

輸入參數productmerchant必填

compare_return_policies

Compare two retailers' return policies

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.

輸入參數merchant_a必填merchant_b必填

search_return_policies

Search the return-policy database

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.

輸入參數limitquerycategory

get_price_match_policy

Get a retailer's price-match policy

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.

輸入參數merchant必填

who_will_price_match

Which retailers will match a given store's price

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.

輸入參數categorymerchant必填

get_merchant_discounts

Get a retailer's military and student discounts

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.

輸入參數merchant必填

search_discounts

Search military and student discounts

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.

輸入參數typelimitquerycategory

get_cancellation_guide

How to cancel a subscription or membership

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.

輸入參數merchant必填

get_birthday_freebie

Get a brand's birthday freebie

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.

輸入參數merchant必填

search_birthday_freebies

Search birthday freebies

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.

輸入參數kidslimitquerycategoryno_signupactually_free

search_deals

Search current deals

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.

輸入參數sortlimitquery必填include_expired

get_deal

Get one deal's full details

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.

輸入參數deal必填

get_deal_of_the_day

Get today's featured deal

Thrifle's editor-picked deal of the day with price, merchant and buy link. Cheap to call; returns found:false when none is set.

無需輸入參數。

get_store_deals

Get current deals at a retailer

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.

輸入參數limitmerchant必填

predict_amazon_price

Retired: Amazon price tool

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.

輸入參數asin_or_url必填

search_blog

Search Thrifle's articles and data studies

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.

輸入參數limitquery必填section

get_blog_post

Read one Thrifle article

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.

輸入參數post必填

search_credit_cards

Search the credit-card database

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.

輸入參數limitqueryissuermerchantstore_cards_onlydeferred_interest_only

get_credit_card

Get one credit card's full terms

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.

輸入參數card_key必填

get_store_credit_cards

Get a retailer's store credit cards

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.

輸入參數merchant必填

get_money_monitor

US economic indicators and rates

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.

無需輸入參數。

get_price_pulse

US consumer prices: CPI by category and gas

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.

無需輸入參數。

check_product_recalls

Check a product for US safety recalls

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.

輸入參數brandproduct必填

about_thrifle

About Thrifle and this server

What Thrifle is, what each database covers and how big it is, how to cite it, and which tool answers which kind of question.

無需輸入參數。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分