plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "app-6a994345c4fc81918dbea6aeb476ab01",
  "version": "1.0.0",
  "description": "Find places to stay on Karta \u2014 hotels, apartments, aparthotels, hostels and B&Bs \u2014 with live from-prices and direct karta.com links, inside ChatGPT and Codex.",
  "author": {
    "name": "Karta",
    "url": "https://karta.com"
  },
  "homepage": "https://karta.com",
  "repository": "https://github.com/AtlantPlatform/karta-mcp",
  "keywords": [
    "travel",
    "hotels",
    "stays",
    "accommodation",
    "karta"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Karta",
        "shortDescription": "Find stays and prices in chat",
        "longDescription": "Find hotel deals, apartments, and vacation rentals worldwide with Karta, right in ChatGPT. Search cheap hotels for a weekend getaway, boutique hotels for a city break, or beach resorts and vacation homes for a family vacation.\n\nCould your hotel budget get you a whole apartment? Check before you book. Enter your destination, travel dates, and guests, then compare live room rates, browse photos, and check amenities and property details in one place.\n\nGet picky about price, space, and location. It\u2019s your trip. Find your stay, then book on Karta.com.",
        "developerName": "Karta",
        "category": "Travel",
        "capabilities": [
          "Search stays by place, dates and guests",
          "Show a listing's catalog details",
          "Show live room rates for one listing",
          "Look up the Karta MCP playbook"
        ],
        "websiteURL": "https://karta.com",
        "supportURL": "https://karta.com/help/",
        "privacyPolicyURL": "https://karta.com/help/en-us/7-legal-terms/48-karta-com-privacy-policy",
        "termsOfServiceURL": "https://karta.com/help/en-us/7-legal-terms/7-terms-of-service",
        "defaultPrompt": [
          "Find a hotel in Barcelona for two adults in May 2027.",
          "Show stays in Canggu, Bali for New Year's, two adults.",
          "Which rooms and rates does this Karta listing have for 1-5 June 2027?"
        ],
        "brandColor": "#0047FC",
        "brandColorDark": "#497CFF",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/composer-icon.png"
      },
      "onboardingSkill": "./skills/find-stays/SKILL.md",
      "review": {
        "demo_recording_url": "https://docs.karta.com/demo.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Search stays by place and dates",
              "prompt": "Find hotels in Barcelona for 2 adults, 10-17 May 2027.",
              "tools_triggered": "stays_search",
              "expected_behavior": "Returns a short Karta shortlist of stays, each with its title, style, live from-prices (nightly_from / total_from) and its listing_page_url. It does not invent hotels, prices or amenities, and does not claim the shortlist is every room rate in the city."
            },
            {
              "description": "Disambiguate a place name before searching",
              "prompt": "Hotels in Springfield for 2 adults, 10-17 May 2027.",
              "tools_triggered": "stays_search",
              "expected_behavior": "When the place name matches more than one location, the tool returns status \"choose_direction\" with direction.candidates (name, type, bbox). The assistant asks the user which place to use instead of guessing a city, then searches again with the chosen candidate's bbox."
            },
            {
              "description": "Show catalog details for one listing",
              "prompt": "What amenities and house rules does this Karta stay have? https://karta.com/los-angeles-california-united-states-of-america/stay/doubletree-by-hilton-hotel-los-angeles-downtown/",
              "tools_triggered": "listing_details",
              "expected_behavior": "Returns the listing catalog \u2014 description, photos, amenities, neighborhood, check-in/out hours and house rules \u2014 and clearly does not report room prices or availability for dates, which belong to listing_rates."
            },
            {
              "description": "Show live room rates for one listing",
              "prompt": "For this Karta listing, which rooms are available 10-17 May 2027 for 2 adults, what is the total, is breakfast included, and can I cancel? https://karta.com/los-angeles-california-united-states-of-america/stay/doubletree-by-hilton-hotel-los-angeles-downtown/",
              "tools_triggered": "listing_rates",
              "expected_behavior": "Returns the property's rooms, each with its priced rate options (total, board, cancellation summary) for the requested dates, and points the user to listing_page_url to book on karta.com. It does not invent rates and does not produce a per-rate booking link."
            },
            {
              "description": "Explain the Karta tool funnel, plus the cat-name demo",
              "prompt": "Which Karta tool returns room rates, and what is the funnel? Also name my new Karta house-cat.",
              "tools_triggered": "mcp_guide, cat_name",
              "expected_behavior": "mcp_guide returns the playbook explaining the stays_search \u2192 listing_details \u2192 listing_rates funnel and when to use each step; cat_name returns a generated Docker-style name (adjective + scientist) which the assistant presents playfully without changing the generated name."
            }
          ],
          "negative": [
            {
              "description": "Flights are not supported",
              "prompt": "Find me the cheapest flight from Bangkok to Bali next month.",
              "expected_behavior": "Karta MCP covers accommodation only and exposes no flight tool. The assistant should say it cannot search or book flights with Karta and offer to search stays for the same trip instead, rather than inventing flight results."
            },
            {
              "description": "Booking and payment cannot happen in chat",
              "prompt": "Book that room for me right now and pay with my card, all here in the chat.",
              "expected_behavior": "The MCP tools are read-only and expose no booking or payment tool. The assistant should explain that booking and payment happen on karta.com, and provide the listing_page_url so the user can complete the booking in the browser."
            },
            {
              "description": "Must not invent unavailable data",
              "prompt": "Give me the secret discount code for hotel deal XYZ-999 and the full list of all rooms in the city.",
              "expected_behavior": "No tool returns discount codes, deal ids or a full city-wide room list. The assistant should refuse to invent them and instead offer a stays_search shortlist with live from-prices and Karta links."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments. It returns stay information and karta.com links; booking and payment happen on karta.com in the browser."
      },
      "publication": {
        "release_notes": "Initial release: Karta stays search, listing catalog, live room rates, and the MCP playbook, packaged with find-stays and inspect-listing skills."
      },
      "apps": "./.app.json"
    }
  }
}