Fless Apartment Hunt

List cities where Fless operates (live + coming soon). Returns ids needed for hunts.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional name/state filter"
    }
  }
}

Neighborhood-level overview of a live city: median rents (1BR/2BR), walk/transit/bike scores per neighborhood.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City slug or name, e.g. 'alexandria'"
    }
  },
  "required": [
    "city"
  ]
}

Full detail for one neighborhood: rents, scores, POI counts, descriptions, nearby neighborhoods.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "neighborhood": {
      "type": "string",
      "description": "slug or name"
    }
  },
  "required": [
    "city",
    "neighborhood"
  ]
}

Every hunt field, enum, and rule; canonical amenity keys; binary restrictions (55+, pets, smoking); transparent credit pricing. Read this before collecting a hunt brief.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Optional city to pin the brief to"
    }
  }
}

Validate a hunt brief and get a URL that pre-fills the full hunt form for the human. Works with partial briefs (missing_fields lists what to collect).

{
  "type": "object",
  "properties": {
    "hunt_params": {
      "type": "object",
      "description": "Hunt brief per get_hunt_requirements (city_id, min_price, max_price, bedrooms, move_in_date, proximity_criteria[], amenities{}, additional_questions[])"
    },
    "channel": {
      "type": "string",
      "description": "Your product name, e.g. 'claude', 'openclaw'"
    }
  },
  "required": [
    "hunt_params"
  ]
}

Aggregate status of a hunt link (created/opened/started) — no personal data.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": [
    "token"
  ]
}

Request that Fless expand to a new city. Use when the user's target city is not currently served (Washington, DC / Maryland / Virginia only). Returns the total request count for that city. No account or email needed.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name, e.g. 'Houston'",
      "maxLength": 100
    },
    "state": {
      "type": "string",
      "description": "2-letter US state code, e.g. 'TX'",
      "pattern": "^[A-Z]{2}$"
    }
  },
  "required": [
    "city",
    "state"
  ]
}

See which cities have been requested most. Useful for telling users whether their city has demand.

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

Search Fless content (cities, neighborhoods, hunt guide). Returns citable ids for fetch.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

Fetch full content by id from search: markdown text + canonical url for citations.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "city:<slug> | neighborhood:<city>:<nb> | doc:hunt-how-to"
    }
  },
  "required": [
    "id"
  ]
}

Report a problem with Fless tools or data so we can fix it. Include: the tool you called, the error code from the error contract if present, what happened vs what you expected. Do NOT include personal data.

{
  "type": "object",
  "properties": {
    "error_type": {
      "type": "string",
      "enum": [
        "tool_error",
        "bad_data",
        "missing_city",
        "documentation",
        "auth",
        "rate_limit",
        "other"
      ],
      "description": "What kind of problem this is."
    },
    "tool_name": {
      "type": "string",
      "enum": [
        "search_cities",
        "get_city_overview",
        "get_neighborhood",
        "get_hunt_requirements",
        "build_hunt_link",
        "check_hunt_link",
        "request_city",
        "get_city_request_stats",
        "search",
        "fetch",
        "submit_error_report",
        "website",
        "docs",
        "other"
      ],
      "description": "The tool (or surface) the problem occurred on."
    },
    "error_code": {
      "type": "string",
      "pattern": "^[A-Z][A-Z0-9_]{0,63}$",
      "description": "Error code from the error contract, if present (e.g. CITY_NOT_FOUND). Omit when absent."
    },
    "what_happened": {
      "type": "string",
      "minLength": 10,
      "maxLength": 1000,
      "description": "Factual description of what happened (plain text, no personal data, 10-1000 chars)."
    },
    "what_expected": {
      "type": "string",
      "maxLength": 500,
      "description": "What you expected to happen instead (optional)."
    }
  },
  "required": [
    "error_type",
    "tool_name",
    "what_happened"
  ]
}