{
  "schema_version": "v1",
  "name_for_human": "RentalAnalytics — LandlordIQ",
  "name_for_model": "landlordiq",
  "description_for_human": "Public-data rental market intelligence: statistical median rent estimates (HUD 50th-scaled; FMR is 40th/voucher), vacancy, rent growth, cap-rate benchmarks, lease-renewal advice, and city landlord regulations for U.S. ZIP codes and metros.",
  "description_for_model": "Use LandlordIQ to fetch rental market data for U.S. ZIP codes and metros. Seven read-only GET tools. Every response is a JSON envelope with: data (object|null), confidence_score (integer 0-100), data_freshness (ISO 8601), data_source (provenance string), error (string|null). The market-rent hero is a statistical median: HUD FY2026 50th-percentile rents (NOT FMR) scaled onto the ZIP FMR/SAFMR and aged with BLS CPI Shelter — not MLS asking rent. HUD FMR/SAFMR is the labeled 40th-percentile / voucher figure. ACS B25031 is a second occupied-unit anchor. Do not treat FMR as market rent. Vacancy, rent growth, and cap-rate fields are estimated blends of public datasets and are labeled 'estimated' in data_source. Regulation summaries are plain-English editorial digests, NOT legal advice. Always check confidence_score and data_source before acting; treat confidence_score < 50 as low-trust and surface the caveat to the user. For full context on a single ZIP, prefer get_landlord_market_summary. Coverage is strongest for 15 prebuilt metros; out-of-coverage ZIPs return a national-fallback estimate flagged with data.fallback=true (no invented ZORI).",
  "contact_email": "api@rentalanalytics.com",
  "legal_info_url": "https://rentalanalytics.com/legal/terms.html",
  "muse_url": "https://rentalanalytics.com/muse/",
  "logo_url": "https://rentalanalytics.com/assets/img/favicon.svg",
  "auth": {
    "type": "service_http",
    "authorization_type": "header",
    "authorization_header": "X-API-Key",
    "instructions": "Free tier requires no key (60 requests/hour/IP). For the paid tier (10,000 requests/day per key), email api@rentalanalytics.com to provision a key and send it in the X-API-Key header. CORS is enabled."
  },
  "api": {
    "type": "openapi",
    "url": "https://rentalanalytics.com/openapi.json",
    "is_user_authenticated": false
  },
  "data_semantics": {
    "envelope_fields": ["data", "confidence_score", "data_freshness", "data_source", "error"],
    "confidence_bands": {
      "high": "72-92 — sample ZIP with HUD 50th scaler or curated dataset",
      "moderate": "50-71 — blended/estimated public sources",
      "low": "1-49 — national fallback or extrapolation; surface caveat"
    },
    "estimated_marker": "data_source contains the word 'estimated' when a value is a blended estimate rather than a direct public figure.",
    "not_legal_advice": "Regulation outputs are editorial summaries, not legal advice."
  },
  "tools": [
    { "name": "get_market_rent", "path": "/get_market_rent", "method": "GET", "required": ["zip_code"], "optional": ["bedrooms", "property_type"] },
    { "name": "get_vacancy_rate", "path": "/get_vacancy_rate", "method": "GET", "required": ["city", "state"], "optional": ["property_type"] },
    { "name": "get_rent_growth", "path": "/get_rent_growth", "method": "GET", "required": ["metro"], "optional": ["timeframe"] },
    { "name": "get_cap_rate_benchmark", "path": "/get_cap_rate_benchmark", "method": "GET", "required": [], "optional": ["zip_code", "property_type"] },
    { "name": "get_lease_renewal_recommendation", "path": "/get_lease_renewal_recommendation", "method": "GET", "required": ["current_rent", "zip_code"], "optional": ["bedrooms"] },
    { "name": "get_landlord_market_summary", "path": "/get_landlord_market_summary", "method": "GET", "required": ["zip_code"], "optional": [] },
    { "name": "get_regulations", "path": "/get_regulations", "method": "GET", "required": ["city", "state"], "optional": [] }
  ]
}