fless-mcp

Fless 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

All tools are read-only, no auth needed. Your human creates the account, verifies email, and pays — agents never do.

Install

Claude Desktop / any stdio MCP client

{
  "mcpServers": {
    "fless": {
      "command": "uvx",
      "args": ["fless-mcp"]
    }
  }
}

Or with pip:

pip install fless-mcp
fless-mcp   # speaks JSON-RPC on stdio

Remote (no install needed)

Most clients connect to the hosted server directly:

https://mcp.fless.io/mcp

See per-assistant setup guides (Claude, ChatGPT, Perplexity, Grok, Mistral Vibe, Codex, OpenClaw, Hermes): https://fless.io/ai-agents

Environment

The skill (recommended companion)

fless-apartment-hunt — an Agent Skills-standard skill that teaches your agent the full workflow:

hermes skills install well-known:https://fless.io
# or from GitHub:
npx skills add fless-io/skills

License

MIT