plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "keyva",
  "version": "1.0.1",
  "description": "Recorded Dubai property prices, rents, service charges and broker licences, with the period and record count behind every figure.",
  "author": {
    "name": "Keyva",
    "email": "ravi@keyva.ae",
    "url": "https://www.keyva.ae"
  },
  "homepage": "https://www.keyva.ae",
  "keywords": [
    "dubai",
    "real estate",
    "property prices",
    "rent",
    "uae",
    "mcp"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Keyva",
        "shortDescription": "Dubai property records",
        "longDescription": "Keyva answers questions about Dubai property from recorded transactions, not advertised asking prices.\n\nAsk what homes in an area actually sold for, what tenants actually pay, or whether an asking price is in line with recorded sales. Keyva returns the typical (median) figure with the period it covers and the number of records behind it. When there are too few records for a reliable figure, it says so instead of guessing.\n\nWhat you can ask:\n- Prices: typical price per sq ft by area, project and building; prices by bedroom count; quarterly trends.\n- Price check: an asking price against recorded sales of similar homes in the same area.\n- Rents: typical yearly rent by area and bedroom count, from registered Ejari contracts.\n- Rent increase check: what similar homes let for recently, from registered new contracts.\n- Compare two areas side by side, or list the areas within a purchase or rent budget.\n- Service charges from owners' association budgets on record.\n- Broker licence check against the public register.\n- Developers and their projects, and Keyva's guides on buying and renting in Dubai.\n\nAll 17 tools are read-only. No account or sign-in is needed. Figures come from the official Dubai property register and Ejari rent contract data, processed by Keyva (www.keyva.ae). Keyva states what the records show; it does not forecast prices or give investment advice.",
        "developerName": "Keyva (Fikra Ventures FZE LLC)",
        "category": "Finance",
        "capabilities": [
          "Typical recorded price per sq ft for a Dubai area, project or building, with its period and sales count",
          "Check an asking price against recorded sales of similar homes in the same area",
          "Typical yearly rent by area and bedroom count from registered Ejari contracts",
          "Compare two Dubai areas on the same months: prices, three-year change, gross yield",
          "List the areas where a budget buys or rents a home of a given size",
          "Quarterly price trend for an area, ready and off-plan kept apart",
          "Service charge budgets on record for an area, project or building",
          "Check a broker or agency against the public register of licensed brokers",
          "A developer's registered track record: sales, completed and selling projects",
          "Keyva's guides on buying, renting and costs in Dubai"
        ],
        "websiteURL": "https://www.keyva.ae",
        "supportURL": "https://www.keyva.ae/connect/chatgpt",
        "privacyPolicyURL": "https://www.keyva.ae/legal/privacy",
        "termsOfServiceURL": "https://www.keyva.ae/legal/terms",
        "defaultPrompt": [
          "Is AED 2,000,000 for a 1,000 sq ft apartment in Dubai Marina in line with recorded sales?",
          "Compare Dubai Marina and Jumeirah Lakes Towers for a buyer.",
          "What do 1-bedroom apartments rent for in Dubai Marina?"
        ],
        "brandColor": "#0B4F4A",
        "brandColorDark": "#D4A053",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/composer-icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Price check against recorded sales",
              "prompt": "I've been offered a 1,000 sq ft apartment in Dubai Marina for AED 2,000,000. Is that in line with recorded sales?",
              "tools_triggered": "check_price",
              "expected_behavior": "Returns the median price, the 25th-75th percentile band and the number of comparable completed-home sales of that size in the area over the stated window, and says where the asking price sits. No advice to buy or negotiate."
            },
            {
              "description": "Two areas side by side",
              "prompt": "Compare Dubai Marina and Jumeirah Lakes Towers for a buyer.",
              "tools_triggered": "compare_areas",
              "expected_behavior": "Both areas on the same months: ready and off-plan median price per sq ft with their sales counts, the three-year change and the gross yield with counts. No ranking and no recommendation."
            },
            {
              "description": "Rents by bedroom count",
              "prompt": "What do 1-bedroom apartments rent for in Dubai Marina?",
              "tools_triggered": "search_areas, rent_by_bedrooms",
              "expected_behavior": "The typical yearly rent for a 1-bedroom apartment in Dubai Marina from registered new lets, with the number of contracts and the months covered."
            },
            {
              "description": "Areas within a budget",
              "prompt": "Which areas can I buy a 1-bedroom apartment in for under AED 1.5 million?",
              "tools_triggered": "areas_within_budget",
              "expected_behavior": "Up to eight areas where the typical recorded price for a 1-bedroom apartment is at or under AED 1,500,000, each with its sales count and window. No claim that an area is suitable or good value."
            },
            {
              "description": "Broker licence check",
              "prompt": "Is Realty Solutions a licensed real estate broker in Dubai?",
              "tools_triggered": "check_broker_licence",
              "expected_behavior": "Matching entries from the public broker register snapshot, with licence numbers and what the register's end date supports. A match is stated as registration, not a recommendation."
            }
          ],
          "negative": [
            {
              "description": "Booking is out of scope",
              "prompt": "Book a viewing for a 2-bedroom apartment in Dubai Marina this Saturday.",
              "expected_behavior": "No Keyva tool is used to act. The assistant explains that Keyva only reads public property records and cannot book viewings or contact agents."
            },
            {
              "description": "Outside Dubai",
              "prompt": "What is the average house price in London?",
              "expected_behavior": "Keyva is not used, or it reports that it has no London data. No Dubai figures are given as an answer about London."
            },
            {
              "description": "No forecasts",
              "prompt": "Will Dubai Marina prices go up next year?",
              "expected_behavior": "No forecast. At most, Keyva's recorded quarterly figures for Dubai Marina are given with their periods and counts, and the assistant says that Keyva does not predict prices."
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/1zUV_Hjl-0VYXfc9Prhep6mVtQVycQuZ5/view?usp=sharing",
        "commerce": false
      },
      "publication": {
        "release_notes": "First release: 17 read-only tools over Dubai's recorded sales, rents, service charges and the broker register. No sign-in. Category: Finance (property prices and rents for buyers, tenants and investors)."
      },
      "apps": "./.app.json"
    }
  }
}