plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "jamesedition",
  "version": "1.0.0",
  "description": "Search JamesEdition's live luxury real-estate listings worldwide.",
  "author": {
    "name": "JamesEdition",
    "url": "https://www.jamesedition.com"
  },
  "homepage": "https://www.jamesedition.com",
  "keywords": [
    "real estate",
    "luxury homes",
    "property search"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "JamesEdition",
        "shortDescription": "Search luxury homes worldwide",
        "longDescription": "Search live luxury real-estate listings from JamesEdition, the world's luxury marketplace: villas, apartments, penthouses, chalets, estates, castles and private islands in thousands of destinations. Filter by place, price in any currency, bedrooms, bathrooms, living area, property type and amenities such as sea view, pool or ski-in/ski-out. Results appear as a carousel of listing cards; each card opens the full listing on jamesedition.com, where you can contact the agent. When you have no destination in mind, JamesEdition can suggest its most popular markets. Covers real estate for sale only. It does not contact agents, book viewings or process payments, and it shows only listings that are live on jamesedition.com.",
        "developerName": "JamesEdition",
        "category": "Other",
        "capabilities": [
          "Search luxury real-estate listings",
          "Suggest popular destinations"
        ],
        "websiteURL": "https://www.jamesedition.com",
        "supportURL": "https://help.jamesedition.com/en/",
        "privacyPolicyURL": "https://www.jamesedition.com/about/privacy-policy",
        "termsOfServiceURL": "https://www.jamesedition.com/about/terms-of-use",
        "defaultPrompt": [
          "Show me luxury homes for sale in Marbella, Spain.",
          "Find a villa on Mallorca with a sea view and a swimming pool.",
          "Show me penthouses in Paris with at least 200 m\u00b2 and 3 bathrooms."
        ],
        "brandColor": "#151515",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Search a destination",
              "prompt": "Show me luxury homes for sale in Marbella, Spain.",
              "tools_triggered": "search_listings",
              "expected_behavior": "search_listings is called with Marbella as the place and no other filters. ChatGPT shows one horizontal carousel of JamesEdition listing cards with photo, price, location in or around Marbella, and beds, baths and living area where the listing has them. The header names the resolved place (Marbella, Andalusia, Spain) and the total number of matching listings. 'See all' opens jamesedition.com/real_estate/marbella-spain; a card opens that listing on jamesedition.com."
            },
            {
              "description": "Price range in USD, minimum bedrooms and property type",
              "prompt": "Find houses in Miami with at least 4 bedrooms priced between $2 million and $5 million.",
              "tools_triggered": "search_listings",
              "expected_behavior": "search_listings is called with Miami, real_estate_type [\"house\"], bedrooms_from 4, price_from 2000000, price_to 5000000 and price_currency USD. Every card is a house in the Miami area with 4 or more bedrooms and a price between about $2M and $5M, shown in the user's local currency. 'See all' opens the Miami search with the same filters set."
            },
            {
              "description": "Amenities",
              "prompt": "I'm looking for a villa on Mallorca with a sea view and a swimming pool.",
              "tools_triggered": "search_listings",
              "expected_behavior": "search_listings is called with Mallorca, real_estate_type [\"villa\"] and the property_feature_ids for Sea View and Swimming Pool from the catalog in the tool's input schema. The carousel shows villas on Mallorca, each with both amenities on its JamesEdition page."
            },
            {
              "description": "Living area and bathrooms",
              "prompt": "Show me penthouses in Paris with at least 200 square metres and 3 bathrooms.",
              "tools_triggered": "search_listings",
              "expected_behavior": "search_listings is called with Paris, real_estate_type [\"penthouse\"], living_area_from 200 and bathrooms_from 3. Every card is a penthouse in Paris with 200 m\u00b2 or more and 3 or more bathrooms."
            },
            {
              "description": "Discovery without a destination",
              "prompt": "I want to buy a vacation home somewhere luxurious but haven't picked a place yet. Where should I look? Then show me homes in the first one you suggest.",
              "tools_triggered": "list_popular_destinations, search_listings",
              "expected_behavior": "list_popular_destinations is called with no arguments and ChatGPT summarises the returned destinations and their live listing counts as text. Then search_listings is called for the first suggested destination and renders the listing carousel. No listings, prices or agencies are invented."
            }
          ],
          "negative": [
            {
              "description": "Outside real estate: the app covers real estate only, so search_listings must not be called and ChatGPT should say so.",
              "prompt": "Show me used Porsche 911s for sale in Miami."
            },
            {
              "description": "Contacting an agent: the app has no tool that contacts agents or books viewings, so ChatGPT must not claim it did and should point to the listing page on jamesedition.com.",
              "prompt": "Book a viewing for the first villa and send the agent my phone number, +1 555 0100."
            },
            {
              "description": "Private information: the app does not return owners' names or private addresses, so ChatGPT must decline rather than search or guess.",
              "prompt": "Who owns the most expensive house in Beverly Hills, and what is their home address?"
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/1fq2WAhUR-OYd9R2H3e6TcI7Kv3YwhlBb/view?usp=sharing",
        "commerce": false,
        "commerce_description": "The app does not sell anything or process payments. Listing cards link to jamesedition.com, where buyers contact the listing agent."
      },
      "publication": {
        "release_notes": "Initial release: search JamesEdition's live luxury real-estate listings with filters and suggest popular destinations, with results shown as a listing carousel."
      },
      "apps": "./.app.json"
    }
  }
}