fless-mcp 1.0.0__tar.gz

fless_mcp-1.0.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: fless-mcp
+Version: 1.0.0
+Summary: Fless apartment-hunting MCP server (stdio proxy to https://mcp.fless.io/mcp) — research cities, neighborhoods, rents, and build pre-filled hunt links.
+Author-email: Fless <dev@folyfoly.com>
+License: MIT
+Project-URL: Homepage, https://fless.io/ai-agents
+Project-URL: Documentation, https://fless.io/hunt-how-to.md
+Project-URL: Repository, https://github.com/fless-io/skills
+Project-URL: Changelog, https://github.com/fless-io/skills/blob/main/CHANGELOG.md
+Keywords: mcp,apartment,hunting,rental,ai,agent,llm
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# 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`.
+
+## 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
+
+```json
+{
+  "mcpServers": {
+    "fless": {
+      "command": "uvx",
+      "args": ["fless-mcp"]
+    }
+  }
+}
+```
+
+Or with pip:
+
+```bash
+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
+
+| 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 |
+
+## The skill (recommended companion)
+
+`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
+# or from GitHub:
+npx skills add fless-io/skills
+```
+
+## License
+
+MIT

fless_mcp-1.0.0/README.md

@@ -0,0 +1,70 @@
+# 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`.
+
+## 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
+
+```json
+{
+  "mcpServers": {
+    "fless": {
+      "command": "uvx",
+      "args": ["fless-mcp"]
+    }
+  }
+}
+```
+
+Or with pip:
+
+```bash
+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
+
+| 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 |
+
+## The skill (recommended companion)
+
+`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
+# or from GitHub:
+npx skills add fless-io/skills
+```
+
+## License
+
+MIT

fless_mcp-1.0.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fless-mcp"
+version = "1.0.0"
+description = "Fless apartment-hunting MCP server (stdio proxy to https://mcp.fless.io/mcp) — research cities, neighborhoods, rents, and build pre-filled hunt links."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+authors = [{name = "Fless", email = "dev@folyfoly.com"}]
+keywords = ["mcp", "apartment", "hunting", "rental", "ai", "agent", "llm"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Communications :: Chat",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://fless.io/ai-agents"
+Documentation = "https://fless.io/hunt-how-to.md"
+Repository = "https://github.com/fless-io/skills"
+Changelog = "https://github.com/fless-io/skills/blob/main/CHANGELOG.md"
+
+[project.scripts]
+fless-mcp = "fless_mcp.proxy:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

fless_mcp-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fless_mcp-1.0.0/src/fless_mcp/__init__.py

@@ -0,0 +1,2 @@
+"""fless-mcp — stdio proxy for the Fless remote MCP server (https://mcp.fless.io/mcp)."""
+__version__ = "1.0.0"

fless_mcp-1.0.0/src/fless_mcp/__main__.py

@@ -0,0 +1,5 @@
+"""Entry point: python -m fless_mcp"""
+from .proxy import main
+
+if __name__ == "__main__":
+    main()

fless_mcp-1.0.0/src/fless_mcp/proxy.py

@@ -0,0 +1,70 @@
+"""Stdio <-> Streamable-HTTP proxy for the Fless MCP server.
+
+Bridges local stdio MCP clients (Claude Desktop, etc.) to the remote
+Fless server at https://mcp.fless.io/mcp so `uvx fless-mcp` works as a
+local server entry with zero configuration.
+"""
+import json
+import os
+import sys
+import urllib.request
+
+REMOTE = os.environ.get("FLESS_MCP_URL", "https://mcp.fless.io/mcp")
+UA = os.environ.get("FLESS_MCP_UA", "fless-mcp/1.0.0 (+https://fless.io/ai-agents)")
+
+
+def main():
+    """Pump newline-delimited JSON-RPC between stdin and the remote server.
+
+    The Fless server is stateless (read-only tools), so each request is
+    forwarded independently and the response body is written back verbatim.
+    """
+    while True:
+        line = sys.stdin.readline()
+        if not line:
+            break
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            # Parse to validate; forward the original text unchanged
+            json.loads(line)
+        except json.JSONDecodeError:
+            sys.stderr.write(f"fless-mcp: dropping non-JSON line: {line[:80]}\n")
+            continue
+
+        req = urllib.request.Request(
+            REMOTE,
+            data=line.encode(),
+            headers={
+                "Content-Type": "application/json",
+                "Accept": "application/json, text/event-stream",
+                "User-Agent": UA,
+            },
+            method="POST",
+        )
+        try:
+            with urllib.request.urlopen(req, timeout=120) as resp:
+                body = resp.read().decode(errors="replace")
+                ct = resp.headers.get("content-type", "")
+        except Exception as e:
+            err = {"jsonrpc": "2.0", "id": None,
+                   "error": {"code": -32000, "message": f"fless-mcp proxy error: {e}"}}
+            sys.stdout.write(json.dumps(err) + "\n")
+            sys.stdout.flush()
+            continue
+
+        if "text/event-stream" in ct:
+            # Unwrap SSE: emit each data: payload as its own JSON line
+            for sse_line in body.splitlines():
+                if sse_line.startswith("data:"):
+                    payload = sse_line[5:].strip()
+                    if payload:
+                        sys.stdout.write(payload + "\n")
+        else:
+            sys.stdout.write(body.rstrip("\n") + "\n")
+        sys.stdout.flush()
+
+
+if __name__ == "__main__":
+    main()

fless_mcp-1.0.0/src/fless_mcp.egg-info/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: fless-mcp
+Version: 1.0.0
+Summary: Fless apartment-hunting MCP server (stdio proxy to https://mcp.fless.io/mcp) — research cities, neighborhoods, rents, and build pre-filled hunt links.
+Author-email: Fless <dev@folyfoly.com>
+License: MIT
+Project-URL: Homepage, https://fless.io/ai-agents
+Project-URL: Documentation, https://fless.io/hunt-how-to.md
+Project-URL: Repository, https://github.com/fless-io/skills
+Project-URL: Changelog, https://github.com/fless-io/skills/blob/main/CHANGELOG.md
+Keywords: mcp,apartment,hunting,rental,ai,agent,llm
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# 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`.
+
+## 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
+
+```json
+{
+  "mcpServers": {
+    "fless": {
+      "command": "uvx",
+      "args": ["fless-mcp"]
+    }
+  }
+}
+```
+
+Or with pip:
+
+```bash
+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
+
+| 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 |
+
+## The skill (recommended companion)
+
+`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
+# or from GitHub:
+npx skills add fless-io/skills
+```
+
+## License
+
+MIT

fless_mcp-1.0.0/src/fless_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+src/fless_mcp/__init__.py
+src/fless_mcp/__main__.py
+src/fless_mcp/proxy.py
+src/fless_mcp.egg-info/PKG-INFO
+src/fless_mcp.egg-info/SOURCES.txt
+src/fless_mcp.egg-info/dependency_links.txt
+src/fless_mcp.egg-info/entry_points.txt
+src/fless_mcp.egg-info/top_level.txt

fless_mcp-1.0.0/src/fless_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fless_mcp-1.0.0/src/fless_mcp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fless-mcp = fless_mcp.proxy:main

fless_mcp-1.0.0/src/fless_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+fless_mcp