Rate Ranger

io.rateranger由 rateranger.io 发布官方发布者v1.0.0更新于 Oct 27, 2026

Watch a hotel's price after your user booked it, and email them when it drops enough to rebook.

已验证Streamable HTTP可网页运行位置与生活沟通与协作

概览

AI 生成的概览

Rate Ranger 把旅客已完成的酒店预订加入免费价格监控,若房价下跌到值得改订,就发邮件通知旅客。

可以做什么
  • 为一位旅客提交一至十个已预订的酒店住宿,包含酒店、城市、国家、日期与总价
  • 用提交时返回的读取令牌查回某条预订,确认旅客是否已确认、监控是否已开始
适用场景
适用于用户已经订好酒店、希望在入住前知道房价是否下跌以便改订的情况。它不是酒店搜索或预订工具,且在旅客通过邮件确认前不会监控任何价格。
运行要求
需要把远程 MCP 端点添加为自定义连接器;无需密钥、账号或额外设置。可在 ChatGPT 开发者模式、Claude Code 和 Cursor 中使用,但不能作为 claude.ai 自定义连接器(该处要求 OAuth)。每条预订需提供电子邮箱和 ISO 3166-1 alpha-2 国家代码。
安装前请注意
提交成功并不代表已在监控:旅客点击邮件中的确认链接前不会检查价格,未确认的记录 7 天后删除,因此在核实前不要告诉用户预订已被跟踪。该端点接受任意邮箱地址,提交可能向未主动申请的人发送邮件。按 IP 和按邮箱地址均有每日限额。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Rate Ranger,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.rateranger%2Fhotel-price-monitor/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "rate-ranger": {
      "type": "http",
      "url": "https://www.rateranger.io/api/mcp"
    }
  }
}

README

Rate Ranger for AI agents

Rate Ranger watches what a hotel charges after your user has already booked it, and emails them if the rate drops far enough to be worth rebooking. Free, no account, no app.

This repository is the public contract for doing that programmatically: an OpenAPI spec, an MCP connector manifest, and worked examples.

Do not drive the web form

The form at rateranger.io is protected by a CAPTCHA that issues no token to an automated browser. An assistant will fill every field correctly and then fail at the last step with nothing to click. Use the connector or the API instead.

Option 1: the MCP connector

Add https://www.rateranger.io/api/mcp as a custom connector. No key, no account, no setup beyond the URL.

It exposes two tools:

ToolWhat it does
submit_hotel_bookingEnrols one to ten bookings for one traveller
check_hotel_bookingReads a booking back, including whether it is confirmed yet

Works in ChatGPT (Developer Mode), Claude Code and Cursor. It does not work as a claude.ai custom connector, which requires OAuth; there is no way to declare a server unauthenticated there.

The server speaks protocol revisions 2026-07-28, 2025-11-25, 2025-06-18 and 2025-03-26, so both the current per-request-metadata shape and the older initialize handshake work.

Option 2: the HTTP API

bash
curl -X POST https://www.rateranger.io/api/agent/bookings \  -H 'Content-Type: application/json' \  -d '{    "email": "[email protected]",    "agent": "my-assistant/1.0",    "bookings": [{      "hotel_name": "Novotel Bali Ubud Resort",      "city": "Ubud",      "country": "ID",      "check_in_date": "2027-07-14",      "check_out_date": "2027-07-17",      "total_price": 742.50,      "currency": "USD"    }]  }'

Answers 202 Accepted with a read_token per booking.

The traveller has to confirm. Tell them so.

A successful submission monitors nothing. Rate Ranger emails the traveller one link. Until they click it, no price is checked and no alert can fire. If they never click, everything is deleted after 7 days.

So do not tell your user their booking is being tracked. Tell them to check their inbox, then confirm it yourself with check_hotel_booking or GET /api/agent/bookings/{token} before you say anything stronger. Look at booking.confirmed, which is false until they act.

This is why no key is needed. The endpoint takes an email address from whoever calls it, so if submission alone started the service, anyone could sign any address up for mail it never asked for. The confirmation step is what makes an open API safe to leave open.

country is required, and it matters

ISO 3166-1 alpha-2, for example JP or ID. It decides which rate source can find the hotel at all. A booking without one cannot be monitored properly, so it is required here even though the web form treats it as optional.

Limits

Per day
Anonymous caller, by IP50 bookings
With a key100 bookings
One email address, from one caller3 bookings
One email address, from anyone10 bookings

Email [email protected] for a key if you need more.

Prices may include decimals. Only the web form restricts them to whole numbers.

Errors

Every error carries a stable code to branch on, plus a message for a human reading a log. Branch on code; the wording may change.

CodeMeaning
invalid_emailNot a valid address
disposable_emailA throwaway provider, which cannot receive alerts
invalid_tokenSignature failed, wrong token type, or expired
not_foundToken verified but matches no booking
rate_limitedA daily limit was reached

Full request and response shapes are in openapi.json.

Support

[email protected]

来源:README.md,提交 c9c9d02

工具

2

submit_hotel_booking

Enrol a hotel booking the traveller has ALREADY made into free price monitoring. Rate Ranger watches what the hotel charges for the same dates and emails them if it drops far enough to be worth rebooking. IMPORTANT: this monitors nothing on its own. The traveller is emailed one confirmation link, and no price is checked until they click it. Tell your user to expect that email. Do not tell them the booking is being tracked until check_hotel_booking says it is. Unconfirmed bookings are deleted after 7 days. Use this only for a booking that already exists. It does not search for or make reservations.

输入参数agentemail必填bookings必填

check_hotel_booking

Check one booking you submitted, using the read token returned at submission. Use it to find out whether the traveller has confirmed yet: `confirmed` is false until they click the emailed link, and while it is false nothing is being monitored. Check here before telling your user their booking is being tracked.

输入参数token必填

版本历史

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

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。