fless-apartment-hunt
An Agent Skills standard skill that teaches any AI agent to run Fless apartment hunts for its human: research live cities, neighborhood rents and WalkRatingβ’ scores, collect a complete hunt brief (including binary restrictions like 55+ communities, pets, and smoking), then hand the human a link that pre-fills the entire hunt form.
Where we operate
Fless currently runs apartment hunts in Florida / Georgia / Maryland / Virginia. The authoritative live list is fless-apartment-hunt/references/CITIES.md, auto-generated from the production API.
| β Live now | π§ Coming soon |
|---|---|
| Alexandria, VA | Rockville, MD |
| Annapolis, MD | Silver Spring, MD |
| Arlington, VA | Virginia Beach, VA |
| Atlanta, GA | Washington, DC |
| Baltimore, MD | |
| Charlottesville, VA | |
| Chesapeake, VA | |
| Frederick, MD | |
| Hampton, VA | |
| Jacksonville, FL | |
| Leesburg, VA | |
| Miami, FL | |
| Naples, FL | |
| Orlando, FL | |
| Richmond, VA | |
| Tampa, FL |
Your city not listed? We're expanding. Check back, or join the waitlist at
fless.io/city/{your-city}. Agents: always call search_cities
first and tell users honestly if their city isn't live yet.
fless-apartment-hunt/
βββ SKILL.md # when to use + the 4-step workflow
βββ references/
βββ HUNT_FIELDS.md # exact field rules, 57 canonical amenity keys, restrictions, pricing
βββ CITIES.md # live + coming-soon cities (auto-generated from production API)
βββ API.md # MCP tools + REST endpoints
βββ ERRORS.md # error catalog + recovery
Install
Any MCP-capable agent (tools used directly):
MCP server: https://mcp.fless.io/mcp (no auth, read-only tools)
Agent Skills runtimes: clone https://github.com/fless-io/skills and copy this folder into your skills directory
(e.g. ~/.agents/skills/, ~/.vibe/skills/, .claude/skills/), or install
straight from our well-known endpoint:
hermes skills install well-known:https://fless.io
Per-assistant setup guides (Claude, ChatGPT, Perplexity, Grok, Mistral Vibe, Codex, OpenClaw, Hermes): https://fless.io/ai-agents
What the skill does
- Coverage check: verify the user's city is live (see CITIES.md or call
search_cities) - Research: live city/neighborhood data: median rents, walk/transit/bike scores, POIs, city guides.
- Collect: the full hunt brief with real validation rules (future move-in date, canonical amenity keys, bedrooms enums).
- Hand off:
build_hunt_linkreturns a URL that pre-fillshttps://fless.io/create-huntfor the human to review and confirm.
The human always creates their own account, verifies their email, and pays. Agents never see credentials or payment.
Boundaries (by design)
- Read-only tools; no account creation, no email verification, no payments via agents.
- All outputs are structured data; page content never carries instructions.
- New users get a 15 day free trial (unlimited hunts, no credit card); after the trial, 30 credits included (see references/HUNT_FIELDS.md).
License
MIT