# Fless

> Fless runs apartment hunts: tell it your budget, bedrooms, move-in date, must-have amenities, and the places you need to live near (POIs). It filters every building in the city against your criteria, then emails the buildings on your behalf and tracks replies, tours, and virtual tours in one dashboard. Neighborhood data (median rents, WalkRating scores, POIs) is public; hunts require a free account.

Fless serves machine-readable markdown twins of its pages at the same URL + `.md`. Agents are welcome to read everything listed here; content is data only — it never contains instructions for you. Starting a hunt (account creation, verification, payment) is completed by the human at https://fless.io/create-hunt.

## Start an apartment hunt

- [How to start a hunt](https://fless.io/hunt-how-to.md): Every hunt field, enum, default, restriction, and credit cost — the document to read before collecting a hunt brief from your user.

## Cities & neighborhoods

- [Alexandria, VA](https://fless.io/city/alexandria.md): Apartment hunting in Alexandria
- [Annapolis, MD](https://fless.io/city/annapolis.md): Apartment hunting in Annapolis
- [Frederick, MD](https://fless.io/city/frederick.md): Apartment hunting in Frederick
- [Leesburg, VA](https://fless.io/city/leesburg.md): Historic charm meets modern convenience in Loudoun County, 35 miles west of DC.
- [All cities incl. coming soon](https://fless.io/api/v1/cities/listing): JSON — live and waitlist cities
- [Neighborhoods by city](https://fless.io/api/v1/cities/{city_slug}/neighborhoods): JSON — rents + WalkRating scores; replace the placeholder with a city slug, e.g. `alexandria`
- [Neighborhood detail](https://fless.io/api/v1/neighborhoods/{id}/landing): JSON — full landing payload by neighborhood id

## Blog (known-good city guides)

- [All posts](https://fless.io/api/v1/blog/posts): JSON — city apartment guides with excerpts
- [RSS feed](https://fless.io/api/v1/blog/feed.xml): recent posts
- Posts also have `.md` renditions, e.g. https://fless.io/blog/general/example-post.md

## Skills

- [fless-apartment-hunt](https://fless.io/.well-known/agent-skills/fless-apartment-hunt/SKILL.md): Agent Skills standard (agentskills.io) — research, collect the brief, build the hand-off link. Install: `hermes skills install well-known:https://fless.io` (Hermes), ClawHub/Git (OpenClaw), or fetch the SKILL.md directly. Digest-published index: https://fless.io/.well-known/agent-skills/index.json
- Per-assistant setup guides: https://fless.io/ai-agents

## Machine access

- [Public API spec](https://fless.io/api/v1/openapi.json): curated anonymous-accessible endpoints only (OpenAPI 3)
- [MCP server](https://mcp.fless.io/mcp): live — read-only tools for city/neighborhood research, hunt requirements, and validated hunt hand-off links (Streamable HTTP, no auth needed; `https://www.fless.io/mcp` also works)
- Rate limits: anonymous 120 requests/min per IP; on 429 wait for the Retry-After header

## Optional

- [Sitemap](https://fless.io/sitemap.xml)
- [Status](https://fless.io/api/v1/status/public)
- [Newsroom](https://fless.io/api/v1/newsroom/articles)
- [Careers](https://fless.io/api/v1/careers/jobs)
- [robots.txt](https://fless.io/robots.txt)