Verified stays with receipts: live totals, the street checked on the map, and booking watches.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. Bearer so_live_… key from stayotter.com/account; without it, three trips per connection.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Reads one place the traveller found themselves into the receipts a pick carries: where it is, whether the street is quiet or lively, bars, cafés and restaurants within a ten-minute walk, the distance to a spot they name and, with dates, the lowest total and the lowest they can still cancel, each read now. Takes a Booking.com, Vrbo or Expedia property page, or a hotel's name and city; Airbnb pages cannot be read. Needs a key: one check a day free, Pro up to thirty. 5 to 60 seconds.
A property page URL, or a hotel's name with its city after a comma: 'Hilton Austin, Austin'
A place they will walk to: 'Rainey Street', 'the convention centre'
YYYY-MM-DD; with checkOut, prices are read too
Reads one place the traveller found themselves into the receipts a pick carries: where it is, whether the street is quiet or lively, bars, cafés and restaurants within a ten-minute walk, the distance to a spot they name and, with dates, the lowest total and the lowest they can still cancel, each read now. Takes a Booking.com, Vrbo or Expedia property page, or a hotel's name and city; Airbnb pages cannot be read. Needs a key: one check a day free, Pro up to thirty. 5 to 60 seconds.
| Argument | Type | Description |
|---|---|---|
| city | string | |
| spot | string | A place they will walk to: 'Rainey Street', 'the convention centre' |
| text* | string | A property page URL, or a hotel's name with its city after a comma: 'Hilton Austin, Austin' |
| adults | integer | |
| checkIn | string | YYYY-MM-DD; with checkOut, prices are read too |
| checkOut | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"text"
],
"properties": {
"city": {
"type": "string",
"maxLength": 80
},
"spot": {
"type": "string",
"maxLength": 120,
"description": "A place they will walk to: 'Rainey Street', 'the convention centre'"
},
"text": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "A property page URL, or a hotel's name with its city after a comma: 'Hilton Austin, Austin'"
},
"adults": {
"type": "integer",
"default": 2,
"maximum": 16,
"minimum": 1
},
"checkIn": {
"type": "string",
"description": "YYYY-MM-DD; with checkOut, prices are read too"
},
"checkOut": {
"type": "string"
}
}
}Instant and free: the latest finished standard search for one of the covered cities (a two-adult stay about a month out, refreshed daily). Covered: Austin, Lisbon, Kyoto, Mexico City, New York, Paris, Barcelona, Montreal, San Diego, Edinburgh, Honolulu, London, South Lake Tahoe, Sedona, Holbox, Niagara-on-the-Lake, Bentonville, Knoxville, Asheville, Canmore, Coeur d'Alene, Broken Bow, Lancaster, Ann Arbor. For other places or specific dates use search_stays.
| Argument | Type | Description |
|---|---|---|
| city* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"city"
],
"properties": {
"city": {
"type": "string",
"maxLength": 60,
"minLength": 2
}
}
}Top-rated things to do on Viator for a search's spot and dates (what the trip is for first, the city's best otherwise), with a second place to look when the row is thin. Pass a searchId from search_stays or city_picks; intent overrides the search's own.
| Argument | Type | Description |
|---|---|---|
| intent | string | Override: 'kayaking', 'food tour' |
| searchId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"searchId"
],
"properties": {
"intent": {
"type": "string",
"maxLength": 80,
"description": "Override: 'kayaking', 'food tour'"
},
"searchId": {
"type": "string",
"pattern": "^s_[0-9a-f]{8,32}$"
}
}
}The card for a search by searchId: finished picks with receipts, or its running status. Free and instant. Use it to finish a search_stays call that returned 'running', or to read a shared stay (https://stayotter.com/stay/s_…).
| Argument | Type | Description |
|---|---|---|
| searchId* | string | The searchId from search_stays, or the id in a stayotter.com/stay/s_… link |
| travellerCountry | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"searchId"
],
"properties": {
"searchId": {
"type": "string",
"pattern": "^s_[0-9a-f]{8,32}$",
"description": "The searchId from search_stays, or the id in a stayotter.com/stay/s_… link"
},
"travellerCountry": {
"type": "string",
"maxLength": 2,
"minLength": 2
}
}
}Live search of Booking.com, Vrbo and Expedia (hotel rooms) for the dates and party, verified against the map. Returns up to three picks (best overall, best value, closest) with receipts and tracked openUrl links. Takes 30 to 90 seconds; returns status 'running' with a searchId if it is not done within waitSeconds. Three searches on the house per connection, then a key (free account: 10 a month; Pro: unlimited).
| Argument | Type | Description |
|---|---|---|
| pets | boolean | A pet is coming: only listings whose own policy allows pets |
| vibe | string | |
| where* | string | City or town, with state or country when ambiguous: 'Lisbon', 'Wimberley, TX', 'Kyoto, Japan'. |
| adults | integer | |
| budget | string | value = cheapest that passes, mid = balanced, splurge = the nicest |
| intent | string | What the trip is for, in the traveller's words: 'kayaking', 'a cooking class', 'a quiet writing week'. Steers things to do, never the ranking. |
| walkTo | array | What should be within a ten-minute walk |
| checkIn |
Starts the otter's daily re-run of a finished search, emailing the key's account when a verified pick drops 5% or $50 or the cheapest pick disappears. Needs a key (stayotter.com/connect); the first alert is free with an account, more are Pro.
| Argument | Type | Description |
|---|---|---|
| searchId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"searchId"
],
"properties": {
"searchId": {
"type": "string",
"pattern": "^s_[0-9a-f]{8,32}$"
}
}
}For a stay already booked with free cancellation: pass the confirmation email's text. The otter keeps five facts (property, dates, total paid, deadline, where it was booked), discards the rest (no names, confirmation numbers or card details), reads the property's rate every morning and emails the account when a cheaper rate it can still cancel into appears (5% or $50), with reminders 7, 3 and 1 days before the deadline. Hotels booked direct are read across sellers through Google's rate list. A single whole home has one calendar, so once booked its price can't drop for the traveller: the first read finds the nights taken, the otter emails to say so and offers (free) to watch other whole homes nearby for the same dates until the deadline. Needs a key; free and unlimited. The otter never books or cancels.
| Argument | Type | Description |
|---|---|---|
| paidUsd | number | What they paid in US dollars, when the confirmation is in a currency the otter can't convert |
| confirmation* | string | The confirmation email's text, as the traveller pasted or forwarded it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"confirmation"
],
"properties": {
"paidUsd": {
"type": "number",
"description": "What they paid in US dollars, when the confirmation is in a currency the otter can't convert",
"exclusiveMinimum": 0
},
"confirmation": {
"type": "string",
"maxLength": 12000,
"minLength": 40,
"description": "The confirmation email's text, as the traveller pasted or forwarded it"
}
}
}| string |
| YYYY-MM-DD |
| checkOut* | string | YYYY-MM-DD, 1 to 90 nights after checkIn (Booking.com is skipped past 30 nights; Vrbo quotes longer stays) |
| children | integer |
| flexDays | any | Date flexibility for the alert watcher: 0, 1, 2, 3 or 7 days |
| stayType | string | entire = whole apartments and houses (default); hotel = hotel rooms (Booking.com and Expedia); any = rentals and hotel rooms side by side, each tagged; resort = resorts and all-inclusives, Booking.com only, priced per person too |
| hotelBrands | array | Hotel loyalty: keep hotel picks inside these groups (marriott, hilton, hyatt, ihg, accor, wyndham, choice, bestwestern); whole homes are unaffected |
| maxTotalUsd | number | Hard cap on the whole-stay total in US dollars |
| quietStreet | boolean |
| waitSeconds | integer | How long to wait for the search before returning a running status |
| nearLandmark | string | A place the traveller wants to be near: 'Zilker Park', 'the old town', 'Shinkansen station' |
| travellerCountry | string | ISO-2 country the traveller lives in (default US); decides whether an eSIM line applies |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"where",
"checkIn",
"checkOut"
],
"properties": {
"pets": {
"type": "boolean",
"default": false,
"description": "A pet is coming: only listings whose own policy allows pets"
},
"vibe": {
"enum": [
"lively",
"local",
"calm"
],
"type": "string",
"default": "local"
},
"where": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "City or town, with state or country when ambiguous: 'Lisbon', 'Wimberley, TX', 'Kyoto, Japan'."
},
"adults": {
"type": "integer",
"default": 2,
"maximum": 10,
"minimum": 1
},
"budget": {
"enum": [
"value",
"mid",
"splurge"
],
"type": "string",
"default": "mid",
"description": "value = cheapest that passes, mid = balanced, splurge = the nicest"
},
"intent": {
"type": "string",
"maxLength": 80,
"description": "What the trip is for, in the traveller's words: 'kayaking', 'a cooking class', 'a quiet writing week'. Steers things to do, never the ranking."
},
"walkTo": {
"type": "array",
"items": {
"enum": [
"bars_cafes",
"restaurants",
"groceries",
"transit"
],
"type": "string"
},
"default": [
"bars_cafes"
],
"description": "What should be within a ten-minute walk"
},
"checkIn": {
"type": "string",
"description": "YYYY-MM-DD"
},
"checkOut": {
"type": "string",
"description": "YYYY-MM-DD, 1 to 90 nights after checkIn (Booking.com is skipped past 30 nights; Vrbo quotes longer stays)"
},
"children": {
"type": "integer",
"default": 0,
"maximum": 8,
"minimum": 0
},
"flexDays": {
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 7
}
],
"default": 0,
"description": "Date flexibility for the alert watcher: 0, 1, 2, 3 or 7 days"
},
"stayType": {
"enum": [
"entire",
"hotel",
"any",
"resort"
],
"type": "string",
"default": "entire",
"description": "entire = whole apartments and houses (default); hotel = hotel rooms (Booking.com and Expedia); any = rentals and hotel rooms side by side, each tagged; resort = resorts and all-inclusives, Booking.com only, priced per person too"
},
"hotelBrands": {
"type": "array",
"items": {
"enum": [
"marriott",
"hilton",
"hyatt",
"ihg",
"accor",
"wyndham",
"choice",
"bestwestern"
],
"type": "string"
},
"description": "Hotel loyalty: keep hotel picks inside these groups (marriott, hilton, hyatt, ihg, accor, wyndham, choice, bestwestern); whole homes are unaffected"
},
"maxTotalUsd": {
"type": "number",
"description": "Hard cap on the whole-stay total in US dollars",
"exclusiveMinimum": 0
},
"quietStreet": {
"type": "boolean",
"default": false
},
"waitSeconds": {
"type": "integer",
"default": 45,
"maximum": 150,
"minimum": 0,
"description": "How long to wait for the search before returning a running status"
},
"nearLandmark": {
"type": "string",
"maxLength": 80,
"description": "A place the traveller wants to be near: 'Zilker Park', 'the old town', 'Shinkansen station'"
},
"travellerCountry": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO-2 country the traveller lives in (default US); decides whether an eSIM line applies"
}
}
}