HOUSE 'N' STARS Real Estate Discovery
AI-native real estate discovery with structured property search and market intelligence.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"real-estate-discovery": {
"url": "https://hns-chatgpt-app.onrender.com/mcp"
}
}
}Remote endpoints
https://hns-chatgpt-app.onrender.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢search_hns_properties(query, location, property_type, transaction_type, min_price, ...)
Search real public luxury real estate listings from the HOUSE N STARS structured property dataset using server-side WordPress search. Supports free-text criteria and filters for location, property type, Sale/Rent status, price range, bedrooms and result limit. Returns structured listing data including title, location, property type, transaction type, price display, bedrooms, bathrooms, surface, features and public listing URL.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Free text search, for example sea view, garden, penthouse, waterfront. Do not use this field for sale/rent intent alone; use transaction_type."
},
"location": {
"type": "string",
"description": "Location filter, for example Dubai, Abu Dhabi, Monaco, Nice, Èze."
},
"property_type": {
"type": "string",
"description": "Property type, for example Villa, Apartment, Penthouse, Townhouse."
},
"transaction_type": {
"type": "string",
"description": "Sale/Rent filter. Use exactly Sale for properties for sale and Rent for rental properties. Do not put rent/rental/for rent into query when this parameter is used."
},
"min_price": {
"type": "number",
"description": "Minimum price as a number, without currency symbols."
},
"max_price": {
"type": "number",
"description": "Maximum price as a number, without currency symbols."
},
"bedrooms": {
"type": "number",
"description": "Minimum number of bedrooms requested by the user."
},
"limit": {
"type": "number",
"description": "Maximum number of results to return. Maximum 20."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"source": {
"type": "string"
},
"requested_limit": {
"type": "number"
},
"wordpress_requested_limit": {
"type": "number"
},
"query_posts_count": {
"type": "number"
},
"raw_returned_count": {
"type": "number"
},
"returned_count": {
"type": "number"
},
"found_posts": {
"type": "number"
},
"max_num_pages": {
"type": "number"
},
"count": {
"type": "number"
},
"filters": {
"type": "object",
"properties": {
"search": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"property_type": {
"type": [
"string",
"null"
]
},
"transaction_type": {
"type": [
"string",
"null"
]
},
"min_price": {
"anyOf": [
{
"type": [
"string",
"number"
]
},
{
"type": "null"
}
]
},
"max_price": {
"$ref": "#/properties/filters/properties/min_price"
},
"bedrooms": {
"$ref": "#/properties/filters/properties/min_price"
}
},
"additionalProperties": true
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": [
"string",
"number"
]
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
},
"location": {
"type": [
"string",
"null"
]
},
"property_type": {
"type": "string"
},
"price": {
"$ref": "#/properties/filters/properties/min_price"
},
"price_status": {
"type": "string"
},
"transaction_type": {
"type": "string"
},
"bedrooms": {
"$ref": "#/properties/filters/properties/min_price"
},
"bathrooms": {
"$ref": "#/properties/filters/properties/min_price"
},
"surface": {
"$ref": "#/properties/filters/properties/min_price"
},
"features": {
"type": "array",
"items": {
"type": "string"
}
},
"excerpt": {
"type": "string"
},
"currency": {
"type": [
"string",
"null"
]
},
"price_display": {
"type": "string"
}
},
"required": [
"id",
"title",
"slug",
"url",
"location",
"property_type",
"price",
"price_status",
"transaction_type",
"bedrooms",
"bathrooms",
"surface",
"features",
"excerpt",
"currency",
"price_display"
],
"additionalProperties": false
}
},
"ready_to_use_public_table": {
"type": "string"
},
"public_response_guidance": {
"type": "string"
}
},
"required": [
"status",
"source",
"requested_limit",
"wordpress_requested_limit",
"query_posts_count",
"raw_returned_count",
"returned_count",
"found_posts",
"max_num_pages",
"count",
"filters",
"results",
"ready_to_use_public_table",
"public_response_guidance"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_properties(query, location, property_type, transaction_type, min_price, ...)
Legacy compatibility tool for searching HOUSE N STARS properties. Prefer search_hns_properties for new property searches, especially when the user asks for properties for sale or for rent because search_hns_properties exposes transaction_type as the official Sale/Rent parameter. This legacy tool remains available for backward compatibility and uses the same server-side WordPress search, price_display formatting, POA handling, EUR/AED inference, location cleanup and result table output.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Free text search, for example sea view, garden, penthouse, waterfront. Do not use this field for sale/rent intent alone; use transaction_type."
},
"location": {
"type": "string",
"description": "Location filter, for example Dubai, Abu Dhabi, Monaco, Nice, Èze."
},
"property_type": {
"type": "string",
"description": "Property type, for example Villa, Apartment, Penthouse, Townhouse."
},
"transaction_type": {
"type": "string",
"description": "Sale/Rent filter. Use exactly Sale for properties for sale and Rent for rental properties. Do not put rent/rental/for rent into query when this parameter is used."
},
"min_price": {
"type": "number",
"description": "Minimum price as a number, without currency symbols."
},
"max_price": {
"type": "number",
"description": "Maximum price as a number, without currency symbols."
},
"bedrooms": {
"type": "number",
"description": "Minimum number of bedrooms requested by the user."
},
"limit": {
"type": "number",
"description": "Maximum number of results to return. Maximum 20."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"source": {
"type": "string"
},
"requested_limit": {
"type": "number"
},
"wordpress_requested_limit": {
"type": "number"
},
"query_posts_count": {
"type": "number"
},
"raw_returned_count": {
"type": "number"
},
"returned_count": {
"type": "number"
},
"found_posts": {
"type": "number"
},
"max_num_pages": {
"type": "number"
},
"count": {
"type": "number"
},
"filters": {
"type": "object",
"properties": {
"search": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"property_type": {
"type": [
"string",
"null"
]
},
"transaction_type": {
"type": [
"string",
"null"
]
},
"min_price": {
"anyOf": [
{
"type": [
"string",
"number"
]
},
{
"type": "null"
}
]
},
"max_price": {
"$ref": "#/properties/filters/properties/min_price"
},
"bedrooms": {
"$ref": "#/properties/filters/properties/min_price"
}
},
"additionalProperties": true
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": [
"string",
"number"
]
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
},
"location": {
"type": [
"string",
"null"
]
},
"property_type": {
"type": "string"
},
"price": {
"$ref": "#/properties/filters/properties/min_price"
},
"price_status": {
"type": "string"
},
"transaction_type": {
"type": "string"
},
"bedrooms": {
"$ref": "#/properties/filters/properties/min_price"
},
"bathrooms": {
"$ref": "#/properties/filters/properties/min_price"
},
"surface": {
"$ref": "#/properties/filters/properties/min_price"
},
"features": {
"type": "array",
"items": {
"type": "string"
}
},
"excerpt": {
"type": "string"
},
"currency": {
"type": [
"string",
"null"
]
},
"price_display": {
"type": "string"
}
},
"required": [
"id",
"title",
"slug",
"url",
"location",
"property_type",
"price",
"price_status",
"transaction_type",
"bedrooms",
"bathrooms",
"surface",
"features",
"excerpt",
"currency",
"price_display"
],
"additionalProperties": false
}
},
"ready_to_use_public_table": {
"type": "string"
},
"public_response_guidance": {
"type": "string"
}
},
"required": [
"status",
"source",
"requested_limit",
"wordpress_requested_limit",
"query_posts_count",
"raw_returned_count",
"returned_count",
"found_posts",
"max_num_pages",
"count",
"filters",
"results",
"ready_to_use_public_table",
"public_response_guidance"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_property(id_or_slug)
Retrieve one real public HOUSE N STARS property listing by exact numeric ID or exact slug. Returns structured listing details including location, property type, transaction type, price display, bedrooms, bathrooms, surface, features, description and public listing URL.
Input Schema
{
"type": "object",
"properties": {
"id_or_slug": {
"type": "string",
"description": "The property numeric ID or slug returned by search_hns_properties or search_properties."
}
},
"required": [
"id_or_slug"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"source": {
"type": "string"
},
"searched": {
"type": "string"
},
"result": {
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": [
"string",
"number"
]
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"type": "string"
},
"location": {
"type": [
"string",
"null"
]
},
"property_type": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": [
"string",
"number"
]
},
{
"type": "null"
}
]
},
"price_status": {
"type": "string"
},
"transaction_type": {
"type": "string"
},
"bedrooms": {
"$ref": "#/properties/result/properties/price"
},
"bathrooms": {
"$ref": "#/properties/result/properties/price"
},
"surface": {
"$ref": "#/properties/result/properties/price"
},
"features": {
"type": "array",
"items": {
"type": "string"
}
},
"excerpt": {
"type": "string"
},
"currency": {
"type": [
"string",
"null"
]
},
"price_display": {
"type": "string"
},
"image": {
"type": "string"
}
},
"required": [
"id",
"title",
"slug",
"url",
"location",
"property_type",
"price",
"price_status",
"transaction_type",
"bedrooms",
"bathrooms",
"surface",
"features",
"excerpt",
"currency",
"price_display"
],
"additionalProperties": false
},
"public_response_guidance": {
"type": "string"
}
},
"required": [
"status"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_hns_dataset_overview
Explain what the HOUSE N STARS ChatGPT connector provides as a read-only AI-native luxury real estate dataset. Use this when the user asks what HOUSE N STARS covers, what data the app can access, whether it is read-only, which markets are represented, or why the connector is useful inside ChatGPT. This tool summarizes dataset scope and limitations; it does not search individual listings and does not retrieve archival HNS research reports unless dedicated tools are added later.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"service": {
"type": "string"
},
"version": {
"type": "string"
},
"name": {
"type": "string"
},
"positioning": {
"type": "string"
},
"read_only": {
"type": "boolean"
},
"public_data_only": {
"type": "boolean"
},
"data_source": {
"type": "string"
},
"wordpress_status_api": {
"type": "string"
},
"wordpress_properties_api": {
"type": "string"
},
"approximate_active_property_records": {
"type": "number"
},
"returned_property_sample_count": {
"type": "number"
},
"primary_markets": {
"type": "array",
"items": {
"type": "string"
}
},
"exposed_dataset_fields": {
"type": "array",
"items": {
"type": "string"
}
},
"connector_capabilities": {
"type": "array",
"items": {
"type": "string"
}
},
"hns_intelligence_context": {
"type": "array",
"items": {
"type": "string"
}
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"tools": {
"type": "array",
"items": {
"type": "string"
}
},
"public_response_guidance": {
"type": "string"
}
},
"required": [
"status",
"service",
"version",
"name",
"positioning",
"read_only",
"public_data_only",
"data_source",
"wordpress_status_api",
"wordpress_properties_api",
"approximate_active_property_records",
"returned_property_sample_count",
"primary_markets",
"exposed_dataset_fields",
"connector_capabilities",
"hns_intelligence_context",
"limitations",
"tools",
"public_response_guidance"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢hns_api_status
Check whether the HOUSE N STARS WordPress property API is reachable through the Render MCP server.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"service": {
"type": "string"
},
"version": {
"type": "string"
},
"wordpress_status_api": {
"type": "string"
},
"wordpress_properties_api": {
"type": "string"
},
"returned_property_count": {
"type": "number"
},
"wordpress_found_posts": {
"type": "number"
},
"tools": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"status",
"service",
"version",
"wordpress_status_api",
"wordpress_properties_api",
"returned_property_count",
"wordpress_found_posts",
"tools"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence