Fless Apartment Hunt

io.flessPublished by fless.ioOfficial publisherv1.7.0Updated Oct 29, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Fless Apartment Hunt lets an assistant research US city and neighborhood rental data, collect a hunt brief, and hand the user a pre-filled apartment hunt link.

What you can do
  • Check coverage and research places: list live and coming-soon cities, get city overviews with median rents and walk/transit/bike scores, and read neighborhood details with POIs
  • Collect a hunt brief: read every hunt field, enum, amenity key and restriction rule, then validate a brief and build a URL that pre-fills the hunt form
  • Track and search content: check the aggregate status of a hunt link, search Fless content and fetch full markdown with citable URLs
  • Request coverage and report problems: record interest in an unserved city, view city request stats, and submit error reports
  • Realtor client funnel (API key required): list and invite clients, create hunts for a client, review and curate…
When to use it
Useful when a user is apartment hunting in a covered US city and wants neighborhood rent and walkability research plus a ready-to-submit hunt brief. Also relevant for licensed realtors with a Fless for Realtors account who want to manage client hunts from an assistant.
Requirements
Remote MCP endpoint at mcp.fless.io; no auth needed for the read-only research and hunt-link tools. The realtor_* tools need an API key created in the Fless realtor dashboard, sent as an Authorization Bearer header, and an active subscription or trial. The human creates the account, verifies email and pays.
Before you install
Realtor tools act on real client data: inviting a client sends an email, sending a curated list moves the hunt to awaiting client approval, and curation changes the candidate list. The realtor plan costs $49.99/mo after a 15-day trial. The API key is a credential and should be kept private. Error reports should not contain personal data.

Installation

In SourceWeft

  1. Open Fless Apartment Hunt in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.fless%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "fless-apartment-hunt": {
      "type": "http",
      "url": "https://mcp.fless.io/mcp"
    }
  }
}

README

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

Source: README.md at commit 74d189a

Tools

19

search_cities

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

Parametersquery

get_city_overview

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

Parameterscityrequired

get_neighborhood

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

Parameterscityrequiredneighborhoodrequired

get_hunt_requirements

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

Parameterscity

request_city

Request that Fless expand to a new city. Use when the user's target city is not currently served (check live coverage first with search_cities). Returns the total request count for that city. No account or email needed.

Parameterscityrequiredstaterequired

get_city_request_stats

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

Takes no parameters.

fetch

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

Parametersidrequired

submit_error_report

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.

Parameterstool_namerequirederror_codeerror_typerequiredwhat_expectedwhat_happenedrequired

realtor_list_clients

Realtor tool: requires Authorization: Bearer with an API key (create one at fless.io/realtor under API keys); anonymous calls return the structured UNAUTHORIZED error. Accepted clients (id, name, email) + pending invitations (email, expires).

Takes no parameters.

realtor_create_client

Realtor tool: requires Authorization: Bearer with an API key (create one at fless.io/realtor under API keys); anonymous calls return the structured UNAUTHORIZED error. Invite a client by email; the invitation email carries a 7-day accept link. Gated on an active subscription/trial.

Parametersemailrequiredlast_namerequiredfirst_namerequired

realtor_create_hunt

Realtor tool: requires Authorization: Bearer with an API key (create one at fless.io/realtor under API keys); anonymous calls return the structured UNAUTHORIZED error. Create a hunt FOR one of your clients (fields mirror get_hunt_requirements). Returns hunt_id + matched_count; the hunt parks at awaiting_realtor_curation. Gated on an active subscription/trial.

Parametersnamecity_idrequiredbedroomsmax_pricemin_priceclient_emailmove_in_dateclient_user_idproximity_criteria

realtor_list_candidate_buildings

Realtor tool: requires Authorization: Bearer with an API key (create one at fless.io/realtor under API keys); anonymous calls return the structured UNAUTHORIZED error. The matched candidate list for one of your hunts (counts + buildings with eligibility, distance, and your curation status).

Parametershunt_idrequired

realtor_curate_hunt

Realtor tool: requires Authorization: Bearer with an API key (create one at fless.io/realtor under API keys); anonymous calls return the structured UNAUTHORIZED error. Curate the candidate list WITHOUT sending: removals [{id, reason?}] and notes [{id, internal_notes?, client_notes?}] (hunt_building ids from realtor_list_candidate_buildings). Not gated.

Parametersnoteshunt_idrequiredremovals

realtor_add_building_to_hunt

Realtor tool: requires Authorization: Bearer with an API key (create one at fless.io/realtor under API keys); anonymous calls return the structured UNAUTHORIZED error. Search your hunt's building inventory by name and manually add the one unambiguous match into the hunt (several matches: top 3 are named and nothing is added).

Parametersqueryrequiredhunt_idrequired

realtor_send_to_client

Realtor tool: requires Authorization: Bearer with an API key (create one at fless.io/realtor under API keys); anonymous calls return the structured UNAUTHORIZED error. Send the curated list to the client: every non-removed building becomes included and the hunt moves to awaiting_client_approval (the CLIENT releases outreach). Gated on an active subscription/trial.

Parametershunt_idrequired

realtor_get_hunt_status

Realtor tool: requires Authorization: Bearer with an API key (create one at fless.io/realtor under API keys); anonymous calls return the structured UNAUTHORIZED error. Status of one of your hunts: review_state, counts, and the client's name.

Parametershunt_idrequired

Version history

6
  1. v1.7.0LatestOct 29, 2026
  2. v1.6.0Oct 26, 2026
  3. v1.5.1Oct 14, 2026
  4. v1.4.1Oct 6, 2026
  5. v1.3.0Oct 1, 2026
  6. v1.2.0Sep 20, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts