MCP Server
Fless Apartment Hunt
io.fless/mcp
What this MCP does
Provides apartment-hunting research for the DC, Maryland, and Virginia region, including neighborhood rents, amenities, and pre-filled hunt links.
Capabilities
Tools
19
tools
build_hunt_link
Validate a hunt brief and get a URL that pre-fills the full hunt form for the human. Works with partial briefs (missing_fields lists what to collect).
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['hunt_params'], 'properties': {'channel': {'type': 'string', 'description': "Your product name, e.g. 'claude', 'openclaw'"}, 'hunt_params': {'type': 'object', 'description': 'Hunt brief per get_hunt_requirements (city_id, min_price, max_price, bedrooms, move_in_date, proximity_criteria[], amenities{}, additional_questions[])'}}}
check_hunt_link
Aggregate status of a hunt link (created/opened/started) — no personal data.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['token'], 'properties': {'token': {'type': 'string'}}}
fetch
Fetch full content by id from search: markdown text + canonical url for citations.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'city:<slug> | neighborhood:<city>:<nb> | doc:hunt-how-to'}}}
get_city_overview
Neighborhood-level overview of a live city: median rents (1BR/2BR), walk/transit/bike scores per neighborhood.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['city'], 'properties': {'city': {'type': 'string', 'description': "City slug or name, e.g. 'alexandria'"}}}
get_city_request_stats
See which cities have been requested most. Useful for telling users whether their city has demand.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'Optional city to pin the brief to'}}}
get_neighborhood
Full detail for one neighborhood: rents, scores, POI counts, descriptions, nearby neighborhoods.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['city', 'neighborhood'], 'properties': {'city': {'type': 'string'}, 'neighborhood': {'type': 'string', 'description': 'slug or name'}}}
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).
Input schema
{'type': 'object', 'required': ['hunt_id', 'query'], 'properties': {'query': {'type': 'string', 'description': 'Building name fragment (min 2 chars)'}, 'hunt_id': {'type': 'integer'}}}
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.
Input schema
{'type': 'object', 'required': ['email', 'first_name', 'last_name'], 'properties': {'email': {'type': 'string'}, 'last_name': {'type': 'string'}, 'first_name': {'type': 'string'}}}
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.
Input schema
{'type': 'object', 'required': ['name', 'city_id'], 'properties': {'name': {'type': 'string', 'description': "Hunt name, e.g. 'Priya - Capitol Hill 2BR'"}, 'city_id': {'type': 'integer', 'description': 'Live city id (search_cities returns ids)'}, 'bedrooms': {'enum': ['0', '1', '2', '3', '4', '4+', 'studio'], 'type': 'string'}, 'max_price': {'type': 'number', 'description': 'Monthly USD, > min_price'}, 'min_price': {'type': 'number', 'description': 'Monthly USD'}, 'client_email': {'type': 'string', 'description': "Alternative to client_user_id: the client's linked email"}, 'move_in_date': {'type': 'string', 'format': 'YYYY-MM-DD', 'description': 'Must be a future date'}, 'client_user_id': {'type': 'integer', 'description': "Your client's user id (realtor_list_clients). Provide client_user_id OR client_email."}, 'proximity_criteria': {'type': 'array', 'items': {'type': 'object'}, 'description': 'POIs the hunt centers on (name, latitude, longitude, category?, max_distance miles 0.1-10)'}}}
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.
Input schema
{'type': 'object', 'required': ['hunt_id'], 'properties': {'notes': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'integer'}, 'client_notes': {'type': 'string', 'description': 'Shown to the client in review'}, 'internal_notes': {'type': 'string', 'description': 'Private to you (never shown to the client)'}}}}, 'hunt_id': {'type': 'integer'}, 'removals': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'integer'}, 'reason': {'type': 'string'}}}}}}
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.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['hunt_id'], 'properties': {'hunt_id': {'type': 'integer'}}}
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).
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['hunt_id'], 'properties': {'hunt_id': {'type': 'integer'}}}
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).
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
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.
Input schema
{'type': 'object', 'required': ['hunt_id'], 'properties': {'hunt_id': {'type': 'integer'}}}
request_city
Request that Fless expand to a new city. Use when the user's target city is not currently served (Washington, DC / Maryland / Virginia only). Returns the total request count for that city. No account or email needed.
Idempotent
Input schema
{'type': 'object', 'required': ['city', 'state'], 'properties': {'city': {'type': 'string', 'maxLength': 100, 'description': "City name, e.g. 'Houston'"}, 'state': {'type': 'string', 'pattern': '^[A-Z]{2}$', 'description': "2-letter US state code, e.g. 'TX'"}}}
search
Search Fless content (cities, neighborhoods, hunt guide). Returns citable ids for fetch.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string'}}}
search_cities
List cities where Fless operates (live + coming soon). Returns ids needed for hunts.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'query': {'type': 'string', 'description': 'Optional name/state filter'}}}
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.
Input schema
{'type': 'object', 'required': ['error_type', 'tool_name', 'what_happened'], 'properties': {'tool_name': {'enum': ['search_cities', 'get_city_overview', 'get_neighborhood', 'get_hunt_requirements', 'build_hunt_link', 'check_hunt_link', 'request_city', 'get_city_request_stats', 'search', 'fetch', 'submit_error_report', 'website', 'docs', 'other'], 'type': 'string', 'description': 'The tool (or surface) the problem occurred on.'}, 'error_code': {'type': 'string', 'pattern': '^[A-Z][A-Z0-9_]{0,63}$', 'description': 'Error code from the error contract, if present (e.g. CITY_NOT_FOUND). Omit when absent.'}, 'error_type': {'enum': ['tool_error', 'bad_data', 'missing_city', 'documentation', 'auth', 'rate_limit', 'other'], 'type': 'string', 'description': 'What kind of problem this is.'}, 'what_expected': {'type': 'string', 'maxLength': 500, 'description': 'What you expected to happen instead (optional).'}, 'what_happened': {'type': 'string', 'maxLength': 1000, 'minLength': 10, 'description': 'Factual description of what happened (plain text, no personal data, 10-1000 chars).'}}}
History
Recent tool changes
Added
realtor_get_hunt_status
Oct. 1, 2026, 2:43 a.m.
Added
realtor_send_to_client
Oct. 1, 2026, 2:43 a.m.
Added
realtor_add_building_to_hunt
Oct. 1, 2026, 2:43 a.m.
Added
realtor_curate_hunt
Oct. 1, 2026, 2:43 a.m.
Added
realtor_list_candidate_buildings
Oct. 1, 2026, 2:43 a.m.
Added
realtor_create_hunt
Oct. 1, 2026, 2:43 a.m.
Added
realtor_create_client
Oct. 1, 2026, 2:43 a.m.
Added
realtor_list_clients
Oct. 1, 2026, 2:43 a.m.
Added
submit_error_report
Sept. 21, 2026, 2:40 a.m.
Added
fetch
Sept. 21, 2026, 2:40 a.m.
Added
search
Sept. 21, 2026, 2:40 a.m.
Added
get_city_request_stats
Sept. 21, 2026, 2:40 a.m.
Added
request_city
Sept. 21, 2026, 2:40 a.m.
Added
check_hunt_link
Sept. 21, 2026, 2:40 a.m.
Added
build_hunt_link
Sept. 21, 2026, 2:40 a.m.
Added
get_hunt_requirements
Sept. 21, 2026, 2:40 a.m.
Added
get_neighborhood
Sept. 21, 2026, 2:40 a.m.
Added
get_city_overview
Sept. 21, 2026, 2:40 a.m.
Added
search_cities
Sept. 21, 2026, 2:40 a.m.
Discover
Similar MCP servers
US Company Intelligence for AI Agents (SEC EDGAR, x402)
online.x-402/mcp
Offers pay-per-call web extraction, search and LLM tools plus French company, property, procurement, marketplace and security dat…
The Mine Works
com.themineworks/the-mine-works
Aggregates web research tools for company intelligence, leads, recruiting, social and review data, public records, jobs, securiti…
Subastech — subastas judiciales de inmuebles (BOE)
com.subastech/subastas-judiciales
Searches and analyzes Spanish BOE judicial real-estate auctions, with property details, viability reports, alerts, market statist…
Zoning Signal
com.zoningsignal/observatory
Provides searchable and citable US municipal zoning intelligence covering places, corridors, meetings, entities, patterns, and fo…
SPACEXPLORATION
com.spacexploration/listings
Searches and manages commercial real-estate listings, saved searches, property attributes, media, geocoding, and custom-domain li…
FlatHunt
com.flat-hunt/mcp
Searches and compares furnished Berlin housing listings and manages saved listings and search alerts.
Jacob Campbell — Florida Real Estate (The Keyes Company)
com.jacobcampbellrealtor/jacobcampbellrealtor
Provides Florida real estate market figures, MLS search access, referral information, service areas and site content for a specif…
ONR: Mapa do Registro de Imóveis
io.github.mcp-dir/onr_mapa_registro_imoveis-mcp
Queries the official ONR map and property registry information sources in Brazil.