Stay Cost Brain
Tourist and hotel taxes from official sources, worked out night by night for your dates and guests.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"stay-cost-brain": {
"url": "https://staycostbrain.com/mcp"
}
}
}Remote endpoints
https://staycostbrain.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢get_capabilities
What Stay Cost Brain covers: the researched places, how the tax figures are sourced and dated, what it does not do (no room prices, no booking), and the sister services.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"places": {
"type": "array"
},
"method": {
"type": "string"
},
"error": {
"type": "string"
},
"note": {
"type": "string"
}
},
"additionalProperties": true
}🟢list_places
Every place with a researched tourist-tax table: name, country, today's headline rate, the date it was checked, the next re-check date, the towns that set their own tax, and the page with every rate and source.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"places": {
"type": "array"
},
"error": {
"type": "string"
},
"note": {
"type": "string"
}
},
"additionalProperties": true
}🟢tourist_tax(place, town, check_in, nights, adults, ...)
The tourist tax for one stay, worked out night by night: each tax that applies (regional and city parts separately), the amount or the range when the star rating or type of stay is not given, how many nights are charged, how it is paid, announced changes in force on those nights, and the official source and date for each. Accepts a researched place or any town; towns outside the researched places return researched=false. Percentage taxes need room_price_total. Residents', medical and other special exemptions are listed in `rules`, not applied.
Input Schema
{
"type": "object",
"properties": {
"place": {
"type": "string",
"description": "A researched place ('Lisbon', 'Algarve', 'Paris') or any town ('Quarteira', 'Funchal', 'Kyoto')"
},
"town": {
"type": "string",
"description": "Town or municipality inside a region (e.g. 'Albufeira' in the Algarve)"
},
"check_in": {
"type": "string",
"description": "YYYY-MM-DD"
},
"nights": {
"type": "integer",
"minimum": 1,
"maximum": 60,
"description": "Number of nights from check_in (1-60)"
},
"adults": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "Default 2"
},
"adults_70_plus": {
"type": "integer",
"minimum": 0,
"maximum": 20,
"description": "How many of the adults are 70 or over"
},
"child_ages": {
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 17
},
"description": "Age of each child on check-in, one entry per child (many taxes exempt under-12s, -16s or -18s); omit for none"
},
"rooms": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "Default 1 (for per-room taxes)"
},
"type_of_stay": {
"type": "string",
"enum": [
"hotel_1",
"hotel_2",
"hotel_3",
"hotel_4",
"hotel_4_sup",
"hotel_5",
"hotel_5_luxury",
"apartment",
"holiday_rental",
"guesthouse",
"hostel",
"campsite",
"cruise",
"other"
],
"description": "Hotel stars, apartment, holiday rental, etc."
},
"local_category": {
"type": "string",
"description": "The authority's own category label, as returned in options"
},
"area": {
"type": "string",
"description": "Area/zone code where a place has zones (e.g. Venice)"
},
"room_price_total": {
"type": "number",
"description": "Room price for the whole stay, for percentage taxes"
}
},
"required": [
"place",
"check_in",
"nights"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"researched": {
"type": "boolean"
},
"total": {
"type": "object"
},
"taxes": {
"type": "array"
},
"page": {
"type": "string"
},
"error": {
"type": "string"
},
"note": {
"type": "string"
}
},
"additionalProperties": true
}🟢place_rules(place)
Every tourist-tax rule for one researched place: each tax with its authority, legal basis, rates by type of stay, season and area, night caps, exemptions, how it is paid, valid dates and status (verified, inferred, announced), with source links and dates.
Input Schema
{
"type": "object",
"properties": {
"place": {
"type": "string",
"description": "A researched place ('Lisbon', 'Algarve', 'Paris') or any town ('Quarteira', 'Funchal', 'Kyoto')"
}
},
"required": [
"place"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"place": {
"type": "object"
},
"taxes": {
"type": "array"
},
"error": {
"type": "string"
},
"note": {
"type": "string"
}
},
"additionalProperties": true
}🟢hotels_link(place, town, check_in, nights, adults, ...)
A link to live hotel and rental prices for a place or any town and the given dates and guests (Stay22, showing Booking.com, Expedia, Agoda, Vrbo and others). The person sees prices and books there; this tool returns no prices and books nothing. Stay Cost Brain may earn a commission on bookings.
Input Schema
{
"type": "object",
"properties": {
"place": {
"type": "string",
"description": "A researched place ('Lisbon', 'Algarve', 'Paris') or any town ('Quarteira', 'Funchal', 'Kyoto')"
},
"town": {
"type": "string",
"description": "Town inside the place to search in (e.g. 'Albufeira' in the Algarve); omit for the whole place"
},
"check_in": {
"type": "string",
"description": "YYYY-MM-DD"
},
"nights": {
"type": "integer",
"minimum": 1,
"maximum": 60,
"description": "Number of nights from check_in (1-60)"
},
"adults": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "Adults staying (default 2)"
},
"child_ages": {
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 17
},
"description": "Age of each child on check-in, one entry per child (many taxes exempt under-12s, -16s or -18s); omit for none"
}
},
"required": [
"place"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"for": {
"type": "string"
},
"error": {
"type": "string"
},
"note": {
"type": "string"
}
},
"additionalProperties": true
}Community
Evidence