Fless Apartment Hunt

io.fless由 fless.io 发布官方发布者v1.7.0更新于 Oct 29, 2026

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

已验证Streamable HTTP可网页运行位置与生活商业与电商

概览

AI 生成的概览

Fless Apartment Hunt 让助手调研美国城市与社区的租金数据、收集找房需求，并交给用户一个预填好的找房链接。

可以做什么
  • 覆盖与地区调研：列出已上线和即将上线的城市，查看城市各社区租金中位数与步行、公交、骑行评分，读取单个社区的详情与周边设施
  • 收集找房需求：读取全部找房字段、枚举、设施键与限制规则，校验需求并生成可预填找房表单的链接
  • 链接状态与内容检索：查询找房链接的汇总状态，搜索 Fless 内容并按 id 获取带引用网址的完整正文
  • 城市申请与问题反馈：为未覆盖城市提交开通请求、查看城市请求统计、提交错误报告
  • 房产经纪人客户流程（需 API 密钥）：列出并邀请客户、为客户创建找房、查看与筛选候选楼盘、手动添加楼盘、发送清单给客户、查询找房状态
适用场景
适合用户在美国已覆盖城市找房，需要社区租金与步行便利度调研并生成可直接提交的找房需求时使用。也适合拥有 Fless for Realtors 账户的持牌经纪人通过助手管理客户找房流程。
运行要求
远程 MCP 端点 mcp.fless.io；只读的调研与找房链接工具无需认证。realtor_ 开头的工具需要先在 Fless 经纪人后台创建 API 密钥，并以 Authorization Bearer 头发送，且需有效的订阅或试用。账户注册、邮箱验证与付款均由用户本人完成。
安装前请注意
经纪人工具会操作真实客户数据：邀请客户会发送邮件，发送清单会把找房推进到等待客户确认状态，筛选会改动候选列表。经纪人方案试用 15 天后为每月 49.99 美元。API 密钥属于凭据，应妥善保管。错误报告中不要包含个人数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Fless Apartment Hunt，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.fless%2Fmcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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

来源：README.md，提交 74d189a

工具

19

search_cities

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

输入参数query

get_city_overview

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

输入参数city必填

get_neighborhood

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

输入参数city必填neighborhood必填

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.

输入参数city

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.

输入参数city必填state必填

get_city_request_stats

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

无需输入参数。

fetch

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

输入参数id必填

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.

输入参数tool_name必填error_codeerror_type必填what_expectedwhat_happened必填

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).

无需输入参数。

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.

输入参数email必填last_name必填first_name必填

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.

输入参数namecity_id必填bedroomsmax_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).

输入参数hunt_id必填

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.

输入参数noteshunt_id必填removals

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).

输入参数query必填hunt_id必填

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.

输入参数hunt_id必填

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.

输入参数hunt_id必填

版本历史

6
  1. v1.7.0最新Oct 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

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分