fless-mcp 1.2.0 → 1.4.1

package/README.md

@@ -1,35 +1,50 @@
 # fless-mcp
 
-[Fless](https://fless.io) apartment-hunting tools for any MCP-capable AI agent — a zero-dependency stdio proxy to the hosted Fless MCP server at `https://mcp.fless.io/mcp`.
+[Fless](https://fless.io) apartment-hunting tools for any MCP-capable AI agent: a zero-dependency stdio proxy to the hosted Fless MCP server at `https://mcp.fless.io/mcp`.
 
 ## What it does
 
 Your agent researches apartments with live Fless data and hands you a pre-filled hunt link:
 
-- **search_cities** — live + coming-soon cities
-- **get_city_overview** — neighborhoods with median rents + WalkRating™ scores
-- **get_neighborhood** — full detail (rents, scores, POI counts)
-- **get_hunt_requirements** — every hunt field, enum, binary restriction (55+, pets, smoking), transparent pricing
-- **build_hunt_link** — validate a brief → URL that pre-fills the entire hunt form
-- **check_hunt_link** — created → opened → started lifecycle
-- **search / fetch** — ChatGPT deep-research compatibility pair
+- **search_cities**: live + coming-soon cities
+- **get_city_overview**: neighborhoods with median rents + WalkRating(TM) scores
+- **get_neighborhood**: full detail (rents, scores, POI counts)
+- **get_hunt_requirements**: every hunt field, enum, binary restriction (55+, pets, smoking), transparent pricing
+- **build_hunt_link**: validate a brief, get a URL that pre-fills the entire hunt form
+- **check_hunt_link**: created → opened → started lifecycle
+- **search / fetch**: ChatGPT deep-research compatibility pair
+- **request_city**: ask Fless to expand to a new city (write tool, rate-limited)
+- **get_city_request_stats**: see which cities have the most demand
+- **submit_error_report**: report problems with tools or data (write tool, rate-limited)
 
-All tools are read-only, no auth needed. Your human creates the account, verifies email, and pays — agents never do.
+Research and hand-off tools are anonymous, no key needed. Your human creates the account, verifies email, approves the matched buildings, and pays. Agents never do.
+
+Hunts NEVER email buildings automatically: all hunts (2.0.0 approval gate) run an instant matched-building list at creation, park at an approval gate, and Fless emails only the buildings the human explicitly approves in their dashboard. Fail-closed: untouched buildings are removed.
+
+Licensed realtors with a Fless for Realtors account ($49.99/mo flat, 15-day free trial) get 8 authenticated `realtor_*` tools (client funnel: invite, hunt, curate, send to client) by sending an API key from fless.io/realtor as `Authorization: Bearer fless_ak_...` on every MCP call. Anonymous callers keep the public toolset.
 
 ## Where we operate
 
-Fless currently runs apartment hunts in **Washington, DC / Maryland / Virginia** only.
+Fless currently runs apartment hunts in **Florida / Maryland / Virginia**.
+The authoritative live list is the fless-apartment-hunt skill's CITIES.md,
+auto-generated from the production API.
 
 | ✅ Live now | 🚧 Coming soon |
 |---|---|
-| Alexandria, VA | Arlington, VA |
-| Annapolis, MD | Baltimore, MD |
-| Frederick, MD | Rockville, MD |
-| Leesburg, VA | Silver Spring, MD |
-| | Washington, DC |
-| | Richmond, VA + more |
-
-**Your city not listed?** We're expanding — check back, or join the waitlist at
+| Miami, FL | Washington, DC |
+| Naples, FL | Rockville, MD |
+| Annapolis, MD | Silver Spring, MD |
+| Baltimore, MD | Virginia Beach, VA |
+| Frederick, MD | |
+| Alexandria, VA | |
+| Arlington, VA | |
+| Charlottesville, VA | |
+| Chesapeake, VA | |
+| Hampton, VA | |
+| Richmond, VA | |
+| Leesburg, VA | |
+
+**Your city not listed?** We're expanding. Check back, or join the waitlist at
 [fless.io](https://fless.io). Agents: always call `search_cities` first.
 
 ## Install
@@ -40,17 +55,17 @@ Fless currently runs apartment hunts in **Washington, DC / Maryland / Virginia**
 {
   "mcpServers": {
     "fless": {
-      "command": "uvx",
-      "args": ["fless-mcp"]
+      "command": "npx",
+      "args": ["-y", "fless-mcp"]
     }
   }
 }
 ```
 
-Or with pip:
+Or install globally:
 
 ```bash
-pip install fless-mcp
+npm install -g fless-mcp
 fless-mcp   # speaks JSON-RPC on stdio
 ```
 
@@ -69,11 +84,11 @@ See per-assistant setup guides (Claude, ChatGPT, Perplexity, Grok, Mistral Vibe,
 | Variable | Default | Purpose |
 |---|---|---|
 | `FLESS_MCP_URL` | `https://mcp.fless.io/mcp` | Remote server (fallback: `https://www.fless.io/mcp`) |
-| `FLESS_MCP_UA` | `fless-mcp/1.0.0 (+https://fless.io/ai-agents)` | User-Agent |
+| `FLESS_MCP_UA` | `fless-mcp-npm/1.3.0 (+https://fless.io/ai-agents)` | User-Agent |
 
 ## The skill (recommended companion)
 
-`fless-apartment-hunt` — an [Agent Skills](https://agentskills.io)-standard skill that teaches your agent the full workflow:
+`fless-apartment-hunt`: an [Agent Skills](https://agentskills.io)-standard skill that teaches your agent the full workflow:
 
 ```bash
 hermes skills install well-known:https://fless.io
@@ -83,4 +98,4 @@ npx skills add fless-io/skills
 
 ## License
 
-MIT
+MIT

package/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * fless-mcp — stdio proxy for the Fless remote MCP server.
+ * fless-mcp: stdio proxy for the Fless remote MCP server.
  * Bridges local stdio MCP clients (Claude Desktop, etc.) to
  * https://mcp.fless.io/mcp with zero configuration.
  */
@@ -9,7 +9,7 @@ import { request } from 'node:https';
 import { request as httpRequest } from 'node:http';
 
 const REMOTE = process.env.FLESS_MCP_URL || 'https://mcp.fless.io/mcp';
-const UA = process.env.FLESS_MCP_UA || 'fless-mcp-npm/1.2.0 (+https://fless.io/ai-agents)';
+const UA = process.env.FLESS_MCP_UA || 'fless-mcp-npm/1.3.0 (+https://fless.io/ai-agents)';
 
 let inflight = 0;
 let stdinClosed = false;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fless-mcp",
-  "version": "1.2.0",
-  "description": "Fless apartment-hunting MCP server \u2014 research cities, neighborhoods, rents, and build pre-filled hunt links. Stdio proxy to https://mcp.fless.io/mcp.",
+  "version": "1.4.1",
+  "description": "Fless apartment-hunting MCP server: research cities, neighborhoods, rents, and build pre-filled hunt links. Stdio proxy to https://mcp.fless.io/mcp.",
   "main": "./index.js",
   "type": "module",
   "bin": {
@@ -22,4 +22,4 @@
     "type": "git",
     "url": "https://github.com/fless-io/skills"
   }
-}
+}