Giftroam

com.giftroam由 giftroam.com 發布官方發布者v0.3.0更新於 Oct 24, 2026

Send real gifts to 190+ countries: search, check delivery, get a secure checkout link.

已驗證Streamable HTTP可網頁執行位置與生活商業與電商

概覽

AI 產生的概覽

Giftroam 讓助理搜尋可送達 190 多個國家/地區的禮物、查詢配送可行性、產生安全結帳連結並追蹤訂單。

可以做什麼
依目的國家/地區、場合、預算和所需日期搜尋禮物,顯示含運費的最終價格與送達天數,支援游標分頁。查看某個國家/地區內單一禮物的完整資訊:內容、圖片、價格、預計送達區間、替換政策和限制。查詢能否配送至某國家/地區、城市或日期,回傳時間估計與提醒。建立有效期 30 分鐘、附簽章的一次性結帳連結,並回傳訂單摘要。憑買家的私密訂單權杖查詢訂單狀態和下一步操作。列出已登入使用者的訂單,含狀態、預計送達、禮物、目的地和追蹤權杖。
適用情境
適合需要寄送實體禮物到國外時,協助挑選可送達的禮物、確認能否在指定日期前送達,或取得安全完成付款的連結。也適合查詢既有訂單的狀態。
執行需求
透過 streamable HTTP 連線至 mcp.giftroam.com 遠端端點,不需要本機執行環境、套件或環境變數。列出使用者自己的訂單需要經 OAuth 驗證的 Giftroam 連線,權限範圍為 orders:read;訪客連線會回傳 auth_required。
安裝前請注意
結帳連結會導向安全頁面,由該頁面收集收件人姓名、地址、電話、配送資訊和付款資訊,助理不會接觸這些內容。建立結帳連結代表邁向真實購買,請先確認禮物、目的地和價格。訂單查詢依賴買家的私密訂單權杖,它是唯一憑證,應視為敏感資訊。訂單相關工具不會回傳地址、電話號碼或付款資訊。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

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

工具

6

search_gifts

Search gifts deliverable to a country

Find gifts that can be delivered to a destination country, optionally filtered by free text, occasion, budget (minor units) and a needed-by date. Returns a shortlist with final customer prices (delivery included) and delivery days. Paginate with cursor.

輸入參數limitquerycursorlocalecountry必填occasionbudget_maxbudget_mindate_needed

get_gift_details

Get gift details

Full description, contents, images, customer price, estimated delivery window (EST cutoff-aware), substitution policy and restrictions for one gift in one destination country.

輸入參數localecountry必填gift_id必填

check_delivery

Check delivery feasibility

Is delivery to a country (optionally a city, by a date, for a specific gift) feasible? Returns earliest/latest estimate and warnings (PO box, hotel, holiday window) with a suggested action.

輸入參數citylocalecountry必填gift_iddate_needed

create_checkout

Create a checkout link

Create a signed, single-purpose checkout link (30-minute expiry) for one gift to one country. The schema has no recipient fields on purpose: name, address, phone, delivery details and payment are collected on the secure page. Returns an order summary with the link. Retries with the same idempotency_key return the same link.

輸入參數localecountry必填gift_id必填quantitydelivery_dategift_card_textidempotency_key必填

get_order_status

Get order status

Customer-facing status, ETA window and next action for an order. Looked up by the buyer's private order token, issued after payment; the token is the only credential. Never returns address, phone or payment details.

輸入參數localeorder_token必填

list_my_orders

List my orders (signed-in)

The signed-in user's GiftRoam orders: status, ETA window, gift, destination and the order token for tracking. Requires the authenticated GiftRoam connection (OAuth, scope orders:read); on a guest connection it returns auth_required. Never returns addresses, phone numbers or payment details.

輸入參數limitlocale

版本歷史

1
  1. v0.3.0最新Sep 16, 2026

評分

已滿足適用檢查項的 83%

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

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

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。