GotCashback MCP 伺服器

將 Claude、ChatGPT 及其他相容 MCP 的 AI 助理直接連接至 GotCashback 的目前現金回饋率(線上與實體店,涵蓋各現金回饋平台)、平台比較與付款條款、商店資料及禮品卡優惠 — 每天更新數次。

hk.GotCashback.com 比較全球 41 個國家/地區共 98 個現金回饋平台的現金回饋率,其中 在香港有 2 個平台與 381 家商店。 成立於 2020;由 MNP Enterprises, LLC 營運。

什麼是 MCP?

Model Context Protocol(MCP)是一項開放標準,讓 AI 助理能在對話中呼叫外部工具並取得最新資料。AI 不必再依過時的訓練資料猜測現金回饋率,而是可以直接查詢 GotCashback 的伺服器並取得今天的數字。

安裝說明

Claude(claude.ai / Claude Desktop)

  1. 開啟「設定 → 連接器」(Claude Desktop:設定 → 連接器;claude.ai:對話中的連接器圖示)。
  2. 點選「新增自訂連接器」。
  3. 輸入網址: https://mcp.gotcashback.com
  4. 為它取個名稱(例如「GotCashback」)並儲存。
  5. 在任何需要查詢現金回饋的對話中啟用該連接器 — Claude 會在相關時自動呼叫工具。

Claude Code(終端機)

用一個指令新增伺服器:

claude mcp add --transport http gotcashback https://mcp.gotcashback.com

在 Claude Code 中執行 /mcp 以檢查連線,並在需要帳戶工具時登入。

ChatGPT

  1. 開啟「設定 → 連接器」(適用於支援自訂/開發者連接器的方案)。
  2. 選擇新增自訂連接器並輸入伺服器網址: https://mcp.gotcashback.com
  3. 依照提示授權,並在聊天或自訂 GPT 的設定中啟用。

VS Code(GitHub Copilot 代理模式)

從命令面板執行「MCP: Add Server」,或將以下內容加入 .vscode/mcp.json:

{
  "servers": {
    "gotcashback": {
      "type": "http",
      "url": "https://mcp.gotcashback.com"
    }
  }
}

其他相容 MCP 的用戶端(Cursor、Windsurf 等)

大多數 MCP 用戶端接受指向遠端伺服器的 JSON 設定。典型的項目如下:

{
  "mcpServers": {
    "gotcashback": {
      "url": "https://mcp.gotcashback.com"
    }
  }
}

請查閱您所用用戶端的文件以確認設定檔位置(例如 Cursor 為 ~/.cursor/mcp.json)— 由於遵循相同的 MCP 規格,上方的網址與結構在大多數用戶端中都相同。

連接後的範例提示

  • 「Best Buy 目前的最佳現金回饋率是多少?」
  • 「Target 有折扣禮品卡嗎?」
  • 「Walmart 在加拿大的最佳現金回饋率是多少?」
  • 「比較 Home Depot 的禮品卡折扣。」
  • 「英國有哪些現金回饋平台?」
  • 「在哪裡購買 Adidas 產品能拿到最高現金回饋?」
  • 「在哪裡買狗糧折扣最大?」
  • 「哪些英國現金回饋平台透過 PayPal 付款,哪個最低提領金額最低?」
  • 「TopCashback 有註冊獎勵嗎?多久付款一次?」
  • 「當 Nike 的現金回饋率達到 10% 時提醒我。」
  • 「把 Best Buy 加入我的收藏商店。」

最後兩個使用選擇性的帳戶工具,會提示您以 GotCashback 帳戶登入。

比較想在 Telegram 上聊天? 試試 GotCashback Telegram 機器人

GotCashback MCP 伺服器能做什麼

連接後,AI 助理可以比較指定商店在各平台的目前線上與實體店現金回饋率、尋找折扣禮品卡、依最佳優惠為販售某品牌或購物分類的商店排名、依國家/地區瀏覽商店,並查詢各平台的付款條款(註冊獎勵、最低提領金額、付款頻率、付款方式)。伺服器會告訴助理哪個工具回答哪類問題,因此像「Walmart 最佳現金回饋」這樣的簡單問題會直接對應到正確的查詢。回饋率每天更新數次。

助理如何選擇工具

伺服器會告訴已連接的助理哪個工具回答哪個問題,因此您可以自然地提問:

  • 指定商店的現金回饋(「Walmart 最佳現金回饋」、「Best Buy 實體店現金回饋」、「比較 Expedia 的現金回饋平台」) → get_cashback_rates_by_store_name
  • 指定商店的折扣禮品卡(「Gap 禮品卡最佳折扣」) → get_gift_cards_by_store_name
  • 在哪裡購買某品牌產品最省錢(「Adidas 產品的最佳現金回饋」) → get_best_deals_by_brand
  • 在哪裡購買某類產品最省錢(「有現金回饋的最便宜狗糧」) → get_best_deals_by_category
  • 平台的註冊獎勵、最低提領金額、付款時程或付款方式 → get_portals_by_name / get_portals
  • 某國家/地區有哪些商店提供現金回饋 → get_stores_by_country

當國家/地區重要時請提及(「在加拿大」、「英國現金回饋」):助理會傳遞小寫國家代碼,例如 us、ca、gb(英國)或 de;未提及時則搜尋所有支援的國家/地區。

助理會直接使用這些工具 — 不需要先列出國家/地區、商店或平台。

可用工具

工具功能主要輸入
get_cashback_rates_by_store_name依名稱比較商店在各平台的目前線上與實體店現金回饋率 — 直接回答「Walmart 最佳現金回饋」store_name, country_code (optional)
get_cashback_rates_by_store_id同上,適用於已從先前結果得知商店 ID 的情況store_id
get_gift_cards_by_store_name依名稱尋找商店的折扣禮品卡並比較折扣store_name, country_code (optional)
get_gift_cards_by_store_id同上,適用於已知商店 ID 的情況store_id
get_best_deals_by_brand依最佳現金回饋率與禮品卡折扣為販售某品牌的商店排名brand_name, country_code (optional)
get_best_deals_by_category同上,適用於購物分類(例如「寵物用品」)category_name, country_code (optional)
get_stores_by_name查詢商店的 ID、國家/地區與頁面連結(不含回饋率)store_name, country_code (optional)
get_stores_by_country瀏覽某國家/地區所有提供現金回饋的商店 — 僅含商店 ID 與連結,不含回饋率;清單可能很長country_code
get_portals列出現金回饋平台及其付款條款(註冊獎勵、最低提領金額、付款頻率、付款方式),可依國家/地區篩選 — 不含商店回饋率country_code (optional)
get_portals_by_name依名稱搜尋平台並回傳其付款條款 — 不含商店回饋率portal_name, country_code (optional)
get_portal_by_id依 ID 取得特定平台及其付款條款portal_id
get_countries列出支援的國家/地區及其代碼(英國為 gb)

country_code 為小寫 ISO 代碼,例如 us、ca、gb(英國)或 de;除非標示為必填,否則為選填。store_id、portal_id 及類似的 ID 來自先前的結果。

結果中的追蹤連結

結果中的每家商店、現金回饋率、禮品卡與平台註冊獎勵都附有 GotCashback 追蹤連結(url,相關時另有 gift_cards_url)。只有透過這些連結點擊,現金回饋才會入帳、禮品卡折扣才會生效、註冊獎勵才會發放。伺服器會指示 AI 用戶端一律顯示這些連結 — 若助理只報回饋率而未附連結,請向它索取連結。

帳戶工具(選擇性登入)

使用您的 GotCashback 帳戶登入(OAuth 2.1 — 您的 AI 用戶端會自動提示)可解鎖額外的個人工具。上述所有比較工具無需登入即可繼續使用。

工具功能主要輸入權限範圍
get_my_profile回傳您的 GotCashback 個人資料(姓名、電子郵件、頭像)profile
get_my_favorite_stores列出您收藏的商店favorites
toggle_favorite_store將商店加入或移出您的收藏store_id, favoritefavorites
get_my_alerts列出您的現金回饋與禮品卡提醒(商店、類型、門檻、最後通知時間)alerts
set_store_alert建立或更新提醒,當商店的現金回饋率或禮品卡折扣達到門檻百分比或更高時以電子郵件通知您store_id, alert_type, threshold_percentalerts
remove_store_alert移除某商店的提醒store_id, alert_typealerts

這些提醒與您在網站「帳戶 → 提醒」中管理的提醒相同:alert_type 為 cashback 或 gift_card,threshold_percent 介於 1 到 100 之間,重新儲存現有提醒會更新其門檻並重新啟用,每個帳戶最多可有 10 個有效提醒。

登入方式

  1. 首次使用帳戶工具時,伺服器會回應授權挑戰,您的 AI 用戶端會在瀏覽器中開啟 GotCashback 登入頁面 — 與網站相同的社群登入。無需註冊或 API 金鑰。
  2. 核准所要求的權限(scopes)後返回您的用戶端。工具呼叫即完成,連線會保持登入狀態 — 要求 offline_access 的用戶端會取得更新權杖,因此不會再次詢問。
  3. 若要中斷連線,請從您的 AI 用戶端移除該連接器。若之後有工具回報缺少權限範圍,請移除並重新加入連接器,讓用戶端重新請求授權。
權限範圍授予的權限
profile讀取您的姓名、電子郵件與頭像
favorites讀取並變更您收藏的商店
alerts讀取、建立與移除您的現金回饋及禮品卡提醒
offline_access更新權杖,讓連線保持登入狀態

伺服器端點

https://mcp.gotcashback.com

這是遠端 MCP 伺服器(Streamable HTTP 傳輸)。您不需要安裝或架設任何東西 — 只要將相容的 AI 助理指向上方網址即可。

給開發者與 AI 代理

伺服器(版本 1.1.0)僅提供工具(不含資源或提示)。每個工具都有標題、說明何時使用的描述、唯讀註解,以及 — 針對比較工具 — 已公布的輸出結構描述。以下端點讓代理或整合程式無需閱讀本頁即可探索並連接:

比較工具以文字形式回傳原始 API JSON,並附上符合其輸出結構描述的型別化結構化內容,讓整合程式無需猜測即可讀取商店、平台、回饋率、「最高」以及線上/實體店欄位。未知的 ID 與 API 中斷會以工具錯誤而非協定失敗的形式回傳。

CORS 對任何來源開放,因此瀏覽器端代理可以直接連接;Mcp-Session-Id 與 WWW-Authenticate 回應標頭已公開。

有問題或遇到困難?

若連線失敗或工具呼叫出錯,請再次確認網址輸入完全為 https://mcp.gotcashback.com,且不含任何尾端路徑。若帳戶工具持續要求登入,請移除並重新加入連接器。如需進一步協助,請聯絡 GotCashback 支援。