HOUSE 'N' STARS Real Estate Discovery
AI-native real estate discovery with structured property search and market intelligence.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"real-estate-discovery": {
"url": "https://hns-chatgpt-app.onrender.com/mcp"
}
}
}远程端点
https://hns-chatgpt-app.onrender.com/mcpstreamable-http它能做什么
工具清单
工具(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.
输入模式
{
"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#"
}输出模式
{
"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.
输入模式
{
"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#"
}输出模式
{
"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.
输入模式
{
"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#"
}输出模式
{
"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.
输入模式
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/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.
输入模式
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/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#"
}社区
证据