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": {
    "hashid": {
      "description": "The building's short hashid (e.g. \"k3m9x2qa\"), as returned by look_up_parcel in parcel.hashid.",
      "type": "string"
    }
  },
  "type": "object",
  "required": [
    "hashid"
  ]
}

{
  "properties": {
    "topic": {
      "description": "One group of questions to read. Leave it out to get every group.",
      "enum": [
        "pricing",
        "listing",
        "leads",
        "finding",
        "ai-assistants",
        "building-data",
        "account"
      ],
      "type": "string"
    }
  },
  "type": "object"
}

{
  "properties": {
    "message": {
      "description": "The feedback itself — what happened, or what should change about the app or the MCP server. 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": {
    "address": {
      "description": "A full US street address with its street number, e.g. \"910 Elysian Fields Ave, New Orleans, LA 70117\". A road, a town or a partial address is refused: the lookup has to name one building.",
      "type": "string"
    }
  },
  "type": "object",
  "required": [
    "address"
  ]
}

{
  "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. Omit to return all statuses.",
      "enum": [
        "draft",
        "pending_payment",
        "active",
        "suspended",
        "sold",
        "leased",
        "withdrawn"
      ],
      "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"
      ]
    },
    "apn": {
      "description": "The county assessor parcel number (APN / parcel ID), if known. Used with the county to find the building if another listing already has it.",
      "type": [
        "string",
        "null"
      ]
    },
    "idempotency_key": {
      "description": "Optional client-generated key (e.g. a UUID) making this create safe to retry: re-sending the same key within 24 hours returns the originally created listing instead of a duplicate.",
      "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_size (INTEGER SQUARE FEET — convert acres × 43,560), lot_size_unit (the unit the size was stated in: sqft | acres | sqm | hectares; display-only), year_built, property_type, place_id (from geocode_address — when the address moves, it matches the listing to a building already on file).",
      "type": [
        "object",
        "null"
      ]
    },
    "pricing": {
      "description": "Pricing fields to update: listing_type (sale|lease). For a sale set sale_price (dollars), or omit it and set price_on_request=true for \"price upon request\". A lease is priced per suite (see spaces); lease_rate_period (per_sqft_year|per_sqft_month|per_month|per_year, default per_sqft_year) is the basis every suite's rate is quoted in. A lease with at most one suite, such as a whole building leased as one, can instead be priced here: lease_rate and available_sqft (INTEGER SQUARE FEET), or price_on_request=true, set that one suite, creating it when there is none. Optionally expires_at (ISO date).",
      "type": [
        "object",
        "null"
      ]
    },
    "marketing": {
      "description": "Marketing copy to update: headline, summary, title_override, highlights (string[]).",
      "type": [
        "object",
        "null"
      ]
    },
    "spaces": {
      "description": "A lease's suites, as the whole list: a suite left out is removed, and an empty list removes them all. A whole building leased as one is a single suite. To change suites, start from the spaces get_listing returns to you as the owner: a suite sent with its id is updated, and any field it leaves out keeps its stored value; a suite without an id is added. Publishing a lease needs at least one available suite with available_sqft and a lease_rate or price_on_request=true.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The suite's id, as get_listing returns it to you as the owner. Omit to add a suite.",
            "type": "integer"
          },
          "name": {
            "description": "Suite label, e.g. \"Suite 200\" or \"Floor 3\".",
            "type": [
              "string",
              "null"
            ]
          },
          "available_sqft": {
            "description": "Available space in INTEGER SQUARE FEET.",
            "type": [
              "integer",
              "null"
            ]
          },
          "lease_rate": {
            "description": "Asking rate in the listing's lease_rate_period basis, e.g. 24.5 for $24.50/SF/yr. Null when quoted on request.",
            "type": [
              "number",
              "null"
            ]
          },
          "lease_type": {
            "description": "How operating expenses are split: nnn, fsg (full service gross), mg (modified gross), or gross.",
            "enum": [
              "nnn",
              "fsg",
              "mg",
              "gross",
              null
            ],
            "type": [
              "string",
              "null"
            ]
          },
          "space_type": {
            "description": "Use of the space: a value from the space_type attribute get_registry returns.",
            "type": [
              "string",
              "null"
            ]
          },
          "available_date": {
            "description": "ISO date the suite is available from.",
            "type": [
              "string",
              "null"
            ]
          },
          "min_term_months": {
            "description": "Shortest lease term offered, in months.",
            "type": [
              "integer",
              "null"
            ]
          },
          "max_term_months": {
            "description": "Longest lease term offered, in months.",
            "type": [
              "integer",
              "null"
            ]
          },
          "status": {
            "description": "available (a new suite's default), pending, or leased. Only available suites are shown and priced.",
            "enum": [
              "available",
              "pending",
              "leased"
            ],
            "type": "string"
          },
          "price_on_request": {
            "description": "true when the rate is quoted on request.",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "type": [
        "array",
        "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\", or \"cover\". Omit to auto-route by MIME (images→photos, PDFs→documents; documents are PDF only). Singleton slots (avatar/cover) 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"
  ]
}