Fless Apartment Hunt

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 California / District of Columbia / Florida / Georgia / Massachusetts / Maryland / North Carolina / Nevada / New York / Pennsylvania / South Carolina / Tennessee / 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
Ashburn, VA
Atlanta, GA
Baltimore, MD
Bethesda, MD
Boston, MA
Brandon, FL
Burlington, NC
Charlotte, NC
Charlottesville, VA
Chesapeake, VA
Columbus, GA
Daytona Beach, FL
Fort Lauderdale, FL
Frederick, MD
Gastonia, NC
Hampton, VA
Hillsborough, NC
Jacksonville, FL
Kennett Square, PA
Kernersville, NC
Key Biscayne, FL
Kissimmee, FL
Lake Panasoffkee, FL
Leesburg, VA
Manhattan, NY
Memphis, TN
Miami, FL
Miami Beach, FL
Middle River, MD
Midlothian, VA
Naples, FL
Nashville, TN
North Port, FL
Orlando, FL
Parkville, MD
Philadelphia, PA
Pittsburgh, PA
Prince Frederick, MD
Raleigh, NC
Reno, NV
Richmond, VA
Rock Hill, SC
San Diego, CA
Sanford, FL
Severn, MD
Signal Mountain, TN
Sterling, VA
Tampa, FL
Towson, MD
Vero Beach, FL
Warsaw, VA
Washington, DC
Woodbridge, VA

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

1. Coverage check: verify the user's city is live (see CITIES.md or call search_cities)
2. Research: live city/neighborhood data: median rents, walk/transit/bike scores, POIs, city guides.
3. Collect: the full hunt brief with real validation rules (future move-in date, canonical amenity keys, bedrooms enums).
4. Hand off: build_hunt_link returns a URL that pre-fills https://fless.io/create-hunt for 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