plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "stay-cost-brain",
  "version": "1.0.0",
  "description": "Tourist and hotel taxes from each authority's own pages: what a stay really adds on top of the room price, worked out for your dates and guests, plus a live hotel-search link.",
  "author": {
    "name": "Stay Cost Brain",
    "email": "hello@staycostbrain.com",
    "url": "https://staycostbrain.com"
  },
  "homepage": "https://staycostbrain.com/mcp",
  "keywords": [
    "tourist tax",
    "city tax",
    "hotel tax",
    "travel",
    "hotels",
    "occupancy tax"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Stay Cost Brain",
        "shortDescription": "Tourist tax for your stay",
        "longDescription": "Stay Cost Brain tells you what a stay really costs on top of the room price: the tourist, city or hotel tax, taken from each tax authority's own pages, regulations or official gazette, with the source and the date it was checked.\n\nAsk about a place or town and your dates, and it works the tax out night by night:\n- every tax that applies, with state, regional and city parts shown separately (Barcelona, Paris, New York);\n- the rate for the type of stay and star rating, or the range when that isn't known;\n- seasons, night caps and long-stay reductions;\n- children's exemptions and reductions;\n- taxes set as a percentage of the room price or by price band (Amsterdam, Tokyo, Kyoto, New York), worked out from the room price you give;\n- announced changes that will be in force on your dates.\n\nIt covers 71 researched places in 19 countries, including Portugal, Spain, Italy, France, Greece, the Netherlands, the UK, Japan and 31 US destinations, and says so plainly when a town hasn't been researched yet. It can also give a link to live hotel and rental prices for the dates and guests, where the person books themselves.\n\nThe figures are the published rates, not quotes: the accommodation charges what is in force on the night. Read-only, no account, nothing personal requested. Stay Cost Brain may earn a commission on bookings made through its links; the traveller pays the same price.\n\nLimitations: tax figures only for the researched places listed by list_places; no room prices of its own; amounts in the place's own currency.",
        "developerName": "Stay Cost Brain",
        "category": "Travel",
        "capabilities": [
          "Tourist tax for your dates and guests",
          "State, regional and city taxes shown separately",
          "Star rating, season and night-cap rules",
          "Children's exemptions and reductions",
          "Percentage and price-band taxes from the room price",
          "Link to live hotel prices"
        ],
        "websiteURL": "https://staycostbrain.com/",
        "supportURL": "https://staycostbrain.com/about/",
        "privacyPolicyURL": "https://staycostbrain.com/privacy/",
        "termsOfServiceURL": "https://staycostbrain.com/terms/",
        "defaultPrompt": [
          "What's the tourist tax for 3 nights in Barcelona?",
          "Do children pay the tourist tax in Lisbon?",
          "How much hotel tax will I pay in New York?"
        ],
        "brandColor": "#7A3E8E",
        "brandColorDark": "#C08BD6",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Stacked regional and city taxes for a hotel stay",
              "prompt": "Using Stay Cost Brain, what is the tourist tax for 3 nights in a 4-star hotel in Barcelona from 20 November 2026 for 2 adults?",
              "tools_triggered": "tourist_tax",
              "expected_behavior": "EUR 50.40 in total: the Catalan regional tax and the Barcelona city surcharge shown separately, per person per night, with the official source and the date it was checked."
            },
            {
              "description": "Town lookup inside a region, night cap and child exemption",
              "prompt": "A week in Quarteira from 10 July 2027, 2 adults and an 8-year-old: how much tourist tax?",
              "tools_triggered": "tourist_tax",
              "expected_behavior": "Quarteira is found in Loul\u00e9 (Algarve): EUR 20, i.e. EUR 2 x 2 adults x 5 nights (Loul\u00e9 charges at most 5 nights); the 8-year-old is exempt."
            },
            {
              "description": "Room-price taxes in the US",
              "prompt": "How much hotel tax will I pay in New York City for 2 nights from 20 November 2026 if the room costs $600 in total?",
              "tools_triggered": "tourist_tax",
              "expected_behavior": "USD 95.50: the 5.875% city hotel tax, $2 per room per night, the 8.875% sales tax on the room and the $1.50 unit fee, each named separately."
            },
            {
              "description": "Who is exempt",
              "prompt": "Who is exempt from the tourist tax in Venice?",
              "tools_triggered": "place_rules",
              "expected_behavior": "Venice's rules from the official source: children's exemptions and reductions, other exemptions, and how the tax is collected, with the check date."
            },
            {
              "description": "Live hotel-search link",
              "prompt": "Find hotels in Lisbon for 20 to 23 November 2026 for 2 adults.",
              "tools_triggered": "hotels_link",
              "expected_behavior": "A Stay22 link with Lisbon, the dates and 2 adults filled in; the assistant says no booking has been made and the person books on the linked site."
            }
          ],
          "negative": [
            {
              "description": "Booking and payment are out of scope",
              "prompt": "Book me a hotel in Paris for next week and pay with my card.",
              "expected_behavior": "Explains it cannot book or take payment; may offer hotels_link so the person books themselves."
            },
            {
              "description": "Place not researched",
              "prompt": "What is the tourist tax in Cusco?",
              "expected_behavior": "Says Cusco has not been researched yet (researched=false) and invents no figure; may offer a hotel-search link."
            },
            {
              "description": "Out of scope: flights",
              "prompt": "Find me a cheap flight to Lisbon.",
              "expected_behavior": "No Stay Cost Brain tool is called; the assistant says the app covers taxes on stays and hotel links only."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/evISx_VxQhM",
        "commerce": false
      },
      "publication": {
        "release_notes": "First release: five read-only tools over Stay Cost Brain's sourced tourist- and hotel-tax tables (71 places, 19 countries)."
      },
      "apps": "./.app.json"
    }
  }
}