Serveur MCP

PropFácil

io.github.jonatanvazquez/propfacil
Cartes et localisation Immobilier Public et accessible MCP 2026-07-28

Ce que fait ce MCP

Searches authorized Mexican property listings and supports listing details, favorites, publishing, contact access, and property result displays.

delete_property_list
Delete a favorite list
Use this when an authenticated user explicitly asks to permanently delete one of their PropFácil favorite lists and its saved entries. Do not use it for removing a single property.
Destructif
Schéma d’entrée
{'type': 'object', 'required': ['listId'], 'properties': {'listId': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Identifier of a favorite list owned by the authenticated user.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['deleted', 'listId'], 'properties': {'listId': {'type': 'string'}, 'deleted': {'type': 'boolean'}}, 'additionalProperties': False}
get_property
Get property details
Use this when the user wants the details of one authorized PropFácil listing and has supplied a listingKey or ID from search_properties.
Lecture seule
Schéma d’entrée
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'A listingKey or listing ID returned by search_properties.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['property'], 'properties': {'property': {'anyOf': [{'type': 'object', 'required': ['listingKey', 'standardStatus', 'transactionType', 'propertyType', 'price', 'currency', 'bedrooms', 'bathrooms', 'livingArea', 'publicRemarks', 'unparsedAddress', 'postalCode', 'city', 'state', 'country', 'latitude', 'longitude', 'media', 'summary', 'apiUrl', 'webUrl', 'confidence', 'contactAvailable', 'sourceAvailable'], 'properties': {'city': {'type': ['string', 'null']}, 'media': {'type': 'array', 'items': {'type': 'object', 'required': ['url', 'width', 'height'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'width': {'type': ['number', 'null']}, 'height': {'type': ['number', 'null']}}, 'additionalProperties': False}, 'maxItems': 12}, 'price': {'type': 'number'}, 'state': {'type': ['string', 'null']}, 'apiUrl': {'type': 'string', 'format': 'uri'}, 'webUrl': {'type': 'string', 'format': 'uri'}, 'country': {'type': 'string'}, 'summary': {'type': 'string'}, 'bedrooms': {'type': ['number', 'null']}, 'currency': {'type': 'string'}, 'latitude': {'type': ['number', 'null']}, 'bathrooms': {'type': ['number', 'null']}, 'longitude': {'type': ['number', 'null']}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'listingKey': {'type': 'string'}, 'livingArea': {'type': ['number', 'null']}, 'postalCode': {'type': ['string', 'null']}, 'propertyType': {'type': 'string'}, 'publicRemarks': {'type': ['string', 'null']}, 'standardStatus': {'type': 'string'}, 'sourceAvailable': {'type': 'boolean'}, 'transactionType': {'enum': ['ForSale', 'ForLease'], 'type': 'string'}, 'unparsedAddress': {'type': ['string', 'null']}, 'contactAvailable': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}
get_property_contact
Get property contact
Use this when the user explicitly asks to contact the advertiser or open the authorized original listing for a property previously returned by PropFácil.
Lecture seule
Schéma d’entrée
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'A listingKey or listing ID returned by search_properties or get_property.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['contact'], 'properties': {'contact': {'anyOf': [{'type': 'object', 'required': ['listingKey', 'phone', 'phoneUrl', 'whatsappUrl', 'sourceUrl', 'webUrl'], 'properties': {'phone': {'type': ['string', 'null']}, 'webUrl': {'type': 'string', 'format': 'uri'}, 'phoneUrl': {'type': ['string', 'null'], 'format': 'uri'}, 'sourceUrl': {'type': ['string', 'null'], 'format': 'uri'}, 'listingKey': {'type': 'string'}, 'whatsappUrl': {'type': ['string', 'null'], 'format': 'uri'}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}
get_property_list
Get a favorite list
Use this when an authenticated user wants to inspect one of their PropFácil favorite lists and its saved properties.
Lecture seule
Schéma d’entrée
{'type': 'object', 'required': ['listId'], 'properties': {'listId': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Identifier of a favorite list owned by the authenticated user.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['list', 'items'], 'properties': {'list': {'type': 'object', 'required': ['id', 'name', 'count', 'createdAt'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'count': {'type': 'integer', 'minimum': 0}, 'createdAt': {'type': 'string', 'format': 'date-time'}}, 'additionalProperties': False}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['property', 'note', 'addedAt'], 'properties': {'note': {'type': 'string'}, 'addedAt': {'type': 'string', 'format': 'date-time'}, 'property': {'type': 'object', 'required': ['listingKey', 'transactionType', 'propertyType', 'price', 'currency', 'bedrooms', 'bathrooms', 'city', 'postalCode', 'latitude', 'longitude', 'photoUrl', 'summary', 'apiUrl', 'webUrl'], 'properties': {'city': {'type': ['string', 'null']}, 'price': {'type': 'number'}, 'apiUrl': {'type': 'string', 'format': 'uri'}, 'webUrl': {'type': 'string', 'format': 'uri'}, 'summary': {'type': 'string'}, 'bedrooms': {'type': ['number', 'null']}, 'currency': {'type': 'string'}, 'latitude': {'type': ['number', 'null']}, 'photoUrl': {'type': ['string', 'null']}, 'bathrooms': {'type': ['number', 'null']}, 'longitude': {'type': ['number', 'null']}, 'listingKey': {'type': 'string'}, 'postalCode': {'type': ['string', 'null']}, 'propertyType': {'type': 'string'}, 'transactionType': {'enum': ['ForSale', 'ForLease'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'maxItems': 200}}, 'additionalProperties': False}
list_property_lists
List favorite lists
Use this when an authenticated user wants to see their PropFácil favorite lists. This returns only lists owned by the linked user.
Lecture seule
Schéma d’entrée
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['lists'], 'properties': {'lists': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'count', 'createdAt'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'count': {'type': 'integer', 'minimum': 0}, 'createdAt': {'type': 'string', 'format': 'date-time'}}, 'additionalProperties': False}, 'maxItems': 100}}, 'additionalProperties': False}
my_listings
List my properties
Use this when an authenticated user asks to review the property listings they published on PropFácil.
Lecture seule
Schéma d’entrée
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['listings'], 'properties': {'listings': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'price', 'currency', 'transactionType', 'city', 'url', 'isLive'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'city': {'type': ['string', 'null']}, 'price': {'type': ['number', 'null']}, 'title': {'type': ['string', 'null']}, 'isLive': {'type': ['boolean', 'null']}, 'currency': {'type': 'string'}, 'transactionType': {'enum': ['ForSale', 'ForLease'], 'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 100}}, 'additionalProperties': False}
publish_property
Publish a property
Use this when an authenticated user explicitly asks to publish a property publicly on PropFácil. This creates a public listing and is safe to retry with the same idempotencyKey.
Accès externe
Schéma d’entrée
{'type': 'object', 'required': ['idempotencyKey', 'transactionType', 'price', 'title', 'description', 'city'], 'properties': {'city': {'type': 'string', 'maxLength': 120, 'minLength': 2, 'description': 'Mexican city or municipality where the property is located.'}, 'price': {'type': 'number', 'maximum': 500000000, 'description': 'Positive advertised price in the selected currency.', 'exclusiveMinimum': 0}, 'state': {'type': 'string', 'maxLength': 120, 'description': 'Mexican state where the property is located, when known.'}, 'title': {'type': 'string', 'maxLength': 160, 'minLength': 8, 'description': 'Public listing title shown to prospective buyers or tenants.'}, 'areaSqm': {'type': 'number', 'maximum': 10000000, 'description': 'Property area in square meters.', 'exclusiveMinimum': 0}, 'bedrooms': {'type': 'integer', 'maximum': 100, 'minimum': 0, 'description': 'Number of bedrooms; use zero only when the property has none.'}, 'currency': {'enum': ['MXN', 'USD'], 'type': 'string', 'default': 'MXN', 'description': 'Currency used for the advertised price.'}, 'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'WGS84 latitude for the property location.'}, 'bathrooms': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Number of bathrooms, including fractional half-bath values when applicable.'}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'WGS84 longitude for the property location.'}, 'description': {'type': 'string', 'maxLength': 5000, 'minLength': 20, 'description': 'Public, accurate description of the property.'}, 'isCommercial': {'type': 'boolean', 'default': False, 'description': 'True for commercial real estate; false for residential real estate.'}, 'idempotencyKey': {'type': 'string', 'pattern': '^[A-Za-z0-9._:-]+$', 'maxLength': 100, 'minLength': 8, 'description': 'Stable unique key for this publish request; reuse it when retrying.'}, 'transactionType': {'enum': ['ForSale', 'ForLease'], 'type': 'string', 'description': 'Whether the property is offered for sale or lease.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['status', 'id', 'url', 'idempotentReplay', 'reasons'], 'properties': {'id': {'type': ['string', 'null']}, 'url': {'type': ['string', 'null']}, 'status': {'enum': ['published', 'rejected'], 'type': 'string'}, 'reasons': {'type': 'array', 'items': {'type': 'string'}}, 'idempotentReplay': {'type': 'boolean'}}, 'additionalProperties': False}
remove_property_from_list
Remove property from favorites
Use this when an authenticated user asks to remove a saved property from one of their PropFácil lists. The list remains available if it becomes empty.
Schéma d’entrée
{'type': 'object', 'required': ['listId', 'propertyId'], 'properties': {'listId': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Identifier of a favorite list owned by the authenticated user.'}, 'propertyId': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'A listingKey for the saved property to remove.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['removed', 'listId', 'propertyId'], 'properties': {'listId': {'type': 'string'}, 'removed': {'type': 'boolean'}, 'propertyId': {'type': 'string'}}, 'additionalProperties': False}
rename_property_list
Rename a favorite list
Use this when an authenticated user asks to rename one of their PropFácil favorite lists.
Schéma d’entrée
{'type': 'object', 'required': ['listId', 'name'], 'properties': {'name': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'New name for the favorite list.'}, 'listId': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Identifier of a favorite list owned by the authenticated user.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['list'], 'properties': {'list': {'type': 'object', 'required': ['id', 'name', 'count', 'createdAt'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'count': {'type': 'integer', 'minimum': 0}, 'createdAt': {'type': 'string', 'format': 'date-time'}}, 'additionalProperties': False}}, 'additionalProperties': False}
render_property_results
Show property results
Use this when, after search_properties, the user would benefit from interactive property cards, comparison, details, or a map. Pass only listing IDs already returned by a data tool.
Lecture seule
Schéma d’entrée
{'type': 'object', 'required': ['propertyIds'], 'properties': {'title': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Short user-facing heading for the rendered property selection.'}, 'propertyIds': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'maxItems': 12, 'minItems': 1, 'description': 'Up to 12 listingKey values returned by search_properties.', 'uniqueItems': True}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['title', 'count', 'properties'], 'properties': {'count': {'type': 'integer', 'minimum': 0}, 'title': {'type': 'string'}, 'properties': {'type': 'array', 'items': {'type': 'object', 'required': ['listingKey', 'standardStatus', 'transactionType', 'propertyType', 'price', 'currency', 'bedrooms', 'bathrooms', 'livingArea', 'publicRemarks', 'unparsedAddress', 'postalCode', 'city', 'state', 'country', 'latitude', 'longitude', 'media', 'summary', 'apiUrl', 'webUrl', 'confidence', 'contactAvailable', 'sourceAvailable'], 'properties': {'city': {'type': ['string', 'null']}, 'media': {'type': 'array', 'items': {'type': 'object', 'required': ['url', 'width', 'height'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'width': {'type': ['number', 'null']}, 'height': {'type': ['number', 'null']}}, 'additionalProperties': False}, 'maxItems': 12}, 'price': {'type': 'number'}, 'state': {'type': ['string', 'null']}, 'apiUrl': {'type': 'string', 'format': 'uri'}, 'webUrl': {'type': 'string', 'format': 'uri'}, 'country': {'type': 'string'}, 'summary': {'type': 'string'}, 'bedrooms': {'type': ['number', 'null']}, 'currency': {'type': 'string'}, 'latitude': {'type': ['number', 'null']}, 'bathrooms': {'type': ['number', 'null']}, 'longitude': {'type': ['number', 'null']}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'listingKey': {'type': 'string'}, 'livingArea': {'type': ['number', 'null']}, 'postalCode': {'type': ['string', 'null']}, 'propertyType': {'type': 'string'}, 'publicRemarks': {'type': ['string', 'null']}, 'standardStatus': {'type': 'string'}, 'sourceAvailable': {'type': 'boolean'}, 'transactionType': {'enum': ['ForSale', 'ForLease'], 'type': 'string'}, 'unparsedAddress': {'type': ['string', 'null']}, 'contactAvailable': {'type': 'boolean'}}, 'additionalProperties': False}, 'maxItems': 12}}, 'additionalProperties': False}
restore_property_results
Restore property results
Use this when the PropFácil app needs to restore the latest public property selection for the current MCP session after its widget is recreated.
Lecture seule
Schéma d’entrée
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['render'], 'properties': {'render': {'type': ['object', 'null'], 'required': ['propertyIds', 'title'], 'properties': {'title': {'type': 'string'}, 'propertyIds': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 12, 'minItems': 1}}, 'additionalProperties': False}}, 'additionalProperties': False}
save_property_to_list
Save property to favorites
Use this when an authenticated user asks to save a property to a favorite list. If no list is supplied, use the idempotent default list named Favoritos.
Schéma d’entrée
{'type': 'object', 'required': ['propertyId'], 'properties': {'note': {'type': 'string', 'maxLength': 500, 'description': 'Optional private note stored with the saved property.'}, 'listId': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Identifier of a favorite list owned by the authenticated user.'}, 'listName': {'type': 'string', 'default': 'Favoritos', 'maxLength': 80, 'minLength': 1, 'description': 'Name for a new favorite list; defaults to Favoritos.'}, 'propertyId': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'A listingKey returned by search_properties.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['saved', 'propertyId', 'list'], 'properties': {'list': {'type': 'object', 'required': ['id', 'name', 'count', 'createdAt'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'count': {'type': 'integer', 'minimum': 0}, 'createdAt': {'type': 'string', 'format': 'date-time'}}, 'additionalProperties': False}, 'saved': {'type': 'boolean'}, 'propertyId': {'type': 'string'}}, 'additionalProperties': False}
search_properties
Search properties
Use this when the user wants to find authorized PropFácil property listings in Mexico by city, transaction type, price, bedrooms, or geographic radius.
Lecture seule
Schéma d’entrée
{'type': 'object', 'properties': {'city': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Mexican city or municipality name explicitly requested by the user.'}, 'near': {'type': 'string', 'pattern': '^-?\\d+(?:\\.\\d+)?,-?\\d+(?:\\.\\d+)?$', 'description': 'Map center as lat,lng. Use only a location explicitly supplied by the user.'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results to return.'}, 'radius': {'type': 'number', 'maximum': 100000, 'minimum': 100, 'description': 'Search radius in meters.'}, 'maxPrice': {'type': 'number', 'minimum': 0, 'description': 'Maximum listing price in the listing currency.'}, 'minPrice': {'type': 'number', 'minimum': 0, 'description': 'Minimum listing price in the listing currency.'}, 'minBedrooms': {'type': 'integer', 'maximum': 100, 'minimum': 0, 'description': 'Minimum number of bedrooms.'}, 'transactionType': {'enum': ['ForSale', 'ForLease'], 'type': 'string', 'description': 'Listing operation: ForSale to buy or ForLease to rent.'}}, 'dependentRequired': {'near': ['radius'], 'radius': ['near']}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['count', 'results', 'nextCursor'], 'properties': {'count': {'type': 'integer', 'minimum': 0}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['listingKey', 'transactionType', 'propertyType', 'price', 'currency', 'bedrooms', 'bathrooms', 'city', 'postalCode', 'latitude', 'longitude', 'photoUrl', 'summary', 'apiUrl', 'webUrl'], 'properties': {'city': {'type': ['string', 'null']}, 'price': {'type': 'number'}, 'apiUrl': {'type': 'string', 'format': 'uri'}, 'webUrl': {'type': 'string', 'format': 'uri'}, 'summary': {'type': 'string'}, 'bedrooms': {'type': ['number', 'null']}, 'currency': {'type': 'string'}, 'latitude': {'type': ['number', 'null']}, 'photoUrl': {'type': ['string', 'null']}, 'bathrooms': {'type': ['number', 'null']}, 'longitude': {'type': ['number', 'null']}, 'listingKey': {'type': 'string'}, 'postalCode': {'type': ['string', 'null']}, 'propertyType': {'type': 'string'}, 'transactionType': {'enum': ['ForSale', 'ForLease'], 'type': 'string'}}, 'additionalProperties': False}}, 'nextCursor': {'type': ['string', 'null']}}, 'additionalProperties': False}
Ajouté
delete_property_list
17 September 2026 12:42
Ajouté
remove_property_from_list
17 September 2026 12:42
Ajouté
rename_property_list
17 September 2026 12:42
Ajouté
save_property_to_list
17 September 2026 12:42
Ajouté
get_property_list
17 September 2026 12:42
Ajouté
list_property_lists
17 September 2026 12:42
Ajouté
my_listings
17 September 2026 12:42
Ajouté
publish_property
17 September 2026 12:42
Ajouté
restore_property_results
17 September 2026 12:42
Ajouté
render_property_results
17 September 2026 12:42
Ajouté
get_property_contact
17 September 2026 12:42
Ajouté
get_property
17 September 2026 12:42
Ajouté
search_properties
17 September 2026 12:42