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。

  • 许可证不适用

    托管服务按其提供方的条款使用,因此这里不要求许可证。此检查项不计入百分比。