Connect your AI

{
  "type": "object",
  "properties": {}
}

{
  "properties": {
    "query": {
      "description": "Free-text search query (street address, city, or keyword). Omit or pass null for no text filter.",
      "type": [
        "string",
        "null"
      ]
    },
    "filters": {
      "description": "Structured filter map keyed by Typesense field name. Ranges as {min?, max?}, multi-select as string[], booleans as true/false. Call get_registry to see valid field names and allowed values.",
      "type": [
        "object",
        "null"
      ]
    },
    "sort": {
      "description": "Sort key. Valid values from get_registry sort_options (e.g. \"listed_at:desc\", \"price:asc\").",
      "type": [
        "string",
        "null"
      ]
    },
    "page": {
      "description": "Page number (1-based). Defaults to 1.",
      "type": [
        "integer",
        "null"
      ]
    },
    "bounds": {
      "description": "Geographic bounding box (degrees) limiting hits to an area. Forward the bounds returned by interpret_search verbatim to honour \"near <place>\" intent; omit for a nationwide search.",
      "properties": {
        "sw_lat": {
          "minimum": -90,
          "maximum": 90,
          "type": "number"
        },
        "sw_lng": {
          "minimum": -180,
          "maximum": 180,
          "type": "number"
        },
        "ne_lat": {
          "minimum": -90,
          "maximum": 90,
          "type": "number"
        },
        "ne_lng": {
          "minimum": -180,
          "maximum": 180,
          "type": "number"
        }
      },
      "type": [
        "object",
        "null"
      ]
    }
  },
  "type": "object"
}

{
  "properties": {
    "hashid": {
      "description": "The short hashid of the listing (e.g. \"a1b2c3d4\"). Found in listing URLs and search hits.",
      "type": "string"
    }
  },
  "type": "object",
  "required": [
    "hashid"
  ]
}

{
  "properties": {
    "prompt": {
      "description": "A natural-language property search sentence from the end user. Example: \"industrial with rail access in Denver under $5m\".",
      "type": "string"
    }
  },
  "type": "object",
  "required": [
    "prompt"
  ]
}

{
  "properties": {
    "message": {
      "description": "The feedback itself — what happened, or what you would improve about the app or the MCP experience. Plain text, max 5000 characters.",
      "type": "string"
    },
    "category": {
      "description": "What kind of feedback this is. Defaults to \"other\".",
      "enum": [
        "bug",
        "feature_request",
        "question",
        "other"
      ],
      "type": "string"
    },
    "email": {
      "description": "Optional contact email if you or your human want a reply. Authenticated callers default to their account email.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object",
  "required": [
    "message"
  ]
}

{
  "properties": {
    "name": {
      "description": "A human-readable name for the saved search. If omitted, a name is derived from the filters.",
      "type": [
        "string",
        "null"
      ]
    },
    "query": {
      "description": "The free-text query string, if any.",
      "type": [
        "string",
        "null"
      ]
    },
    "filters": {
      "description": "The structured filter map to persist (same shape as search_listings filters).",
      "type": [
        "object",
        "null"
      ]
    }
  },
  "type": "object"
}

{
  "type": "object",
  "properties": {}
}

{
  "properties": {
    "id": {
      "description": "The numeric ID of the saved search to delete (from list_my_saved_searches).",
      "type": "integer"
    }
  },
  "type": "object",
  "required": [
    "id"
  ]
}

{
  "properties": {
    "status": {
      "description": "Filter by listing status. One of: draft, pending_payment, active, suspended, sold, leased, withdrawn. Omit to return all statuses.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

{
  "properties": {
    "address": {
      "description": "Free-form address to geocode, e.g. \"3763 Imperial St, Frederick, CO 80516\".",
      "type": "string"
    }
  },
  "type": "object",
  "required": [
    "address"
  ]
}

{
  "properties": {
    "street_address": {
      "description": "Street address of the property.",
      "type": "string"
    },
    "city": {
      "description": "City.",
      "type": "string"
    },
    "county": {
      "description": "County.",
      "type": "string"
    },
    "state": {
      "description": "State (2-letter abbreviation).",
      "type": "string"
    },
    "postal_code": {
      "description": "ZIP/postal code.",
      "type": "string"
    },
    "latitude": {
      "description": "Latitude coordinate.",
      "type": "number"
    },
    "longitude": {
      "description": "Longitude coordinate.",
      "type": "number"
    },
    "property_type": {
      "description": "Property type. Allowed values are listed under the property_type attribute returned by get_registry (e.g. industrial, office, retail, land).",
      "type": "string"
    },
    "listing_type": {
      "description": "Listing type: sale or lease.",
      "enum": [
        "sale",
        "lease"
      ],
      "type": "string"
    },
    "unit": {
      "description": "Unit or suite number, if applicable.",
      "type": [
        "string",
        "null"
      ]
    },
    "formatted_address": {
      "description": "Full formatted address string from geocoder.",
      "type": [
        "string",
        "null"
      ]
    },
    "place_id": {
      "description": "Place ID from geocoder.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object",
  "required": [
    "street_address",
    "city",
    "county",
    "state",
    "postal_code",
    "latitude",
    "longitude",
    "property_type",
    "listing_type"
  ]
}

{
  "properties": {
    "hashid": {
      "description": "Hashid of the listing to update.",
      "type": "string"
    },
    "parcel": {
      "description": "Parcel/address fields to update: street_address, city, county, state, postal_code, latitude, longitude, and optionally unit, lot_acres, year_built, property_type.",
      "type": [
        "object",
        "null"
      ]
    },
    "pricing": {
      "description": "Pricing fields to update: listing_type (sale|lease); for a sale set sale_price (dollars), for a lease set lease_rate (per the lease_rate_period basis, default per_sqft_year) and optionally lease_rate_period (per_sqft_year|per_sqft_month|per_month|per_year). Omit the price and set price_on_request=true for \"price upon request\". Optionally expires_at (ISO date).",
      "type": [
        "object",
        "null"
      ]
    },
    "marketing": {
      "description": "Marketing copy to update: headline, summary, title_override, highlights (string[]).",
      "type": [
        "object",
        "null"
      ]
    }
  },
  "type": "object",
  "required": [
    "hashid"
  ]
}

{
  "properties": {
    "hashid": {
      "description": "Hashid of the listing to update.",
      "type": "string"
    },
    "attributes": {
      "description": "Map of registry field name to value, e.g. {\"attr_parking_spaces\": 40, \"attr_office_class\": \"Class A\", \"attr_industrial_rail_access\": true}. Only fields get_registry marks \"writable\":true are accepted. Multiselect enum fields take an array of allowed values. Send null to clear a field.",
      "type": "object"
    }
  },
  "type": "object",
  "required": [
    "hashid",
    "attributes"
  ]
}

{
  "properties": {
    "hashid": {
      "description": "Hashid of the listing to attach the photo to.",
      "type": "string"
    },
    "source_url": {
      "description": "Public https URL of the image to fetch and attach. Must point directly at an image (jpeg, png, webp, gif, avif, heic/heif) on a publicly-routable host.",
      "type": "string"
    }
  },
  "type": "object",
  "required": [
    "hashid",
    "source_url"
  ]
}

{
  "properties": {
    "attachable_type": {
      "description": "Morph alias of the resource to attach to: \"listing\", \"user\", or \"page\".",
      "type": "string"
    },
    "attachable_id": {
      "description": "Identifier of the attachable resource. For \"listing\" pass the listing hashid (e.g. \"d5yqqgoa\") — the same id every read tool returns. For \"user\" pass \"me\" to attach to yourself. For \"page\" pass its numeric id.",
      "type": "string"
    },
    "filename": {
      "description": "Original filename including extension, e.g. \"front-elevation.jpg\". Used to derive the storage key and extension.",
      "type": "string"
    },
    "content_type": {
      "description": "MIME type of the file, e.g. \"image/jpeg\" or \"application/pdf\". Must match the collection whitelist.",
      "type": "string"
    },
    "size": {
      "description": "Exact byte size of the file. Verified against the uploaded object at confirm time, so it must be accurate.",
      "type": "integer"
    },
    "collection": {
      "description": "Optional explicit collection: \"photos\", \"documents\", \"avatar\", \"logo\", or \"cover\". Omit to auto-route by MIME (images→photos, docs→documents). Singleton slots (avatar/cover/logo) must be set explicitly.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object",
  "required": [
    "attachable_type",
    "attachable_id",
    "filename",
    "content_type",
    "size"
  ]
}

{
  "properties": {
    "attachment_id": {
      "description": "The attachment_id (ULID) returned by sign_attachment_upload. Confirm only after the file bytes have been successfully PUT to the presigned URL.",
      "type": "string"
    }
  },
  "type": "object",
  "required": [
    "attachment_id"
  ]
}

{
  "properties": {
    "attachment_id": {
      "description": "The attachment_id (ULID) of the attachment to delete, as returned by sign_attachment_upload / confirm_attachment_upload or listed in get_listing.",
      "type": "string"
    }
  },
  "type": "object",
  "required": [
    "attachment_id"
  ]
}

{
  "properties": {
    "hashid": {
      "description": "Hashid of the listing to publish.",
      "type": "string"
    }
  },
  "type": "object",
  "required": [
    "hashid"
  ]
}

{
  "properties": {
    "hashid": {
      "description": "Optional. Hashid of a listing to get its latest publish run in detail. Omit to list your recent publish runs across all your listings.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

{
  "properties": {
    "hashid": {
      "description": "Hashid of the listing to withdraw.",
      "type": "string"
    }
  },
  "type": "object",
  "required": [
    "hashid"
  ]
}