English Français العربية

Fless Apartment Hunt

Official registry Other

Apartment hunting across 13 US states: rents, briefs, hunt links.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http fless-apartment-hunt 'https://mcp.fless.io/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "fless-apartment-hunt": {
            "type": "http",
            "url": "https://mcp.fless.io/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. fless-apartment-hunt
  2. Where we operate
  3. Install
  4. What the skill does
  5. Boundaries (by design)
  6. License

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, VARockville, MD
Annapolis, MDSilver Spring, MD
Arlington, VAVirginia Beach, VA
Atlanta, GAWashington, 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

  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

Frequently asked questions

What is Fless Apartment Hunt?

Apartment hunting across 13 US states: rents, briefs, hunt links.

How do I install Fless Apartment Hunt?

It runs as a remote server. In Claude Code: claude mcp add --transport http fless-apartment-hunt 'https://mcp.fless.io/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Fless Apartment Hunt need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Fless Apartment Hunt open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Fless Apartment Hunt?

It is published by fless-io. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.