MCP Server

EPK Properties Public Knowledge MCP

com.epkproperties/public-knowledge
Knowledge & Documentation Real Estate Public & reachable MCP 2025-11-25

What this MCP does

Searches public property listings and guides covering real estate, taxation, residency, relocation, and due diligence in Panama and the Dominican Republic.

fetch
Fetch EPK public document
Use this when the user wants the full public property or guide document identified by a stable public EPK document ID or a prior search result.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Stable public EPK document ID supplied by the user or returned by search.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'title', 'url', 'text'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'text': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': False}
get_guide_section
Get public guide section
Use this when the user supplies a public EPK guide section ID or wants the complete section identified by search_guides.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^guide:(PTY|DOM):(es|en|it):(overview|\\d{2})$', 'description': 'Stable public guide section ID supplied by the user or returned by search_guides.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'title', 'url', 'text', 'kind', 'country', 'countryName', 'image_url', 'language', 'section', 'summary', 'sources'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'const': 'guide'}, 'text': {'type': 'string'}, 'title': {'type': 'string'}, 'country': {'enum': ['PTY', 'DOM'], 'type': 'string'}, 'section': {'type': 'string'}, 'sources': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'summary': {'type': 'string'}, 'language': {'enum': ['es', 'en', 'it'], 'type': 'string'}, 'metadata': {'type': 'object', 'additionalProperties': {}}, 'image_url': {'type': 'string', 'format': 'uri'}, 'countryName': {'type': 'string'}}, 'additionalProperties': False}
get_property
Get public property
Use this when the user supplies a public EPK property UUID or wants full public details for a result returned by search_properties.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['property_id'], 'properties': {'language': {'enum': ['es', 'en', 'it'], 'type': 'string', 'default': 'es'}, 'property_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable public property UUID supplied by the user or returned by search_properties.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'title', 'url', 'text'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'text': {'type': 'string'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object', 'additionalProperties': {}}}, 'additionalProperties': False}
search
Search EPK public knowledge
Use this for EPK public knowledge searches and always when one request combines property listings with guides, regulations, taxes, residency, relocation, or due diligence. It returns both result types in one response and remains compatible with company knowledge and deep research.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Natural-language search query.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'title': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
search_guides
Search public real estate guides
Use this when the user asks only for EPK public guidance about buying, taxation, regulations, residency, locations, rental management, relocation, or due diligence in Panama or the Dominican Republic. If the same request also asks for properties, use search instead so both kinds appear together.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 25, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Topic, regulation, tax, residency, location, or buying-process query.'}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0}, 'country': {'enum': ['PTY', 'DOM'], 'type': 'string'}, 'language': {'enum': ['es', 'en', 'it'], 'type': 'string', 'description': 'Omit to infer the language from the query.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['results', 'total', 'limit', 'offset', 'has_more'], 'properties': {'limit': {'type': 'integer', 'exclusiveMinimum': 0}, 'total': {'type': 'integer', 'minimum': 0}, 'offset': {'type': 'integer', 'minimum': 0}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url', 'text', 'kind', 'country', 'countryName', 'image_url', 'language', 'section', 'summary', 'sources'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'const': 'guide'}, 'text': {'type': 'string'}, 'title': {'type': 'string'}, 'country': {'enum': ['PTY', 'DOM'], 'type': 'string'}, 'section': {'type': 'string'}, 'sources': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'summary': {'type': 'string'}, 'language': {'enum': ['es', 'en', 'it'], 'type': 'string'}, 'metadata': {'type': 'object', 'additionalProperties': {}}, 'image_url': {'type': 'string', 'format': 'uri'}, 'countryName': {'type': 'string'}}, 'additionalProperties': False}}, 'has_more': {'type': 'boolean'}}, 'additionalProperties': False}
search_properties
Search public properties
Use this when the user wants only public EPK Properties listings with explicit country, sale/rent, property type, price, bedroom, bathroom, area, location, or descriptive-keyword filters. SALE and RENT searches also include SALE_AND_RENT listings because they are available for the requested operation. If the same request also asks for guides or regulations, use search instead so both kinds appear together.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': 'Location, property name, address, or keywords matched against public listing text.'}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0}, 'country': {'enum': ['PTY', 'DOM'], 'type': 'string', 'description': 'PTY for Panama or DOM for the Dominican Republic.'}, 'language': {'enum': ['es', 'en', 'it'], 'type': 'string', 'default': 'es', 'description': 'Language for descriptions and canonical listing URLs.'}, 'max_area': {'type': 'number', 'minimum': 0, 'description': 'Maximum area in square metres.'}, 'min_area': {'type': 'number', 'minimum': 0, 'description': 'Minimum area in square metres.'}, 'max_price': {'type': 'number', 'minimum': 0}, 'min_price': {'type': 'number', 'minimum': 0}, 'max_bedrooms': {'type': 'integer', 'minimum': 0, 'description': 'Maximum bedrooms; set equal to min_bedrooms for an exact bedroom count.'}, 'min_bedrooms': {'type': 'integer', 'minimum': 0, 'description': 'Minimum number of bedrooms.'}, 'max_bathrooms': {'type': 'integer', 'minimum': 0, 'description': 'Maximum bathrooms; set equal to min_bathrooms for an exact bathroom count.'}, 'min_bathrooms': {'type': 'integer', 'minimum': 0, 'description': 'Minimum number of bathrooms.'}, 'property_type': {'enum': ['APARTMENT', 'HOUSE', 'VILLA', 'LAND', 'OFFICE', 'COMMERCIAL_LOCAL'], 'type': 'string'}, 'operation_type': {'enum': ['SALE', 'RENT'], 'type': 'string', 'description': 'Search by availability: SALE includes SALE and SALE_AND_RENT listings; RENT includes RENT and SALE_AND_RENT listings.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['results', 'total', 'limit', 'offset', 'has_more'], 'properties': {'limit': {'type': 'integer', 'exclusiveMinimum': 0}, 'total': {'type': 'integer', 'minimum': 0}, 'offset': {'type': 'integer', 'minimum': 0}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url', 'property_id', 'summary', 'image_url', 'country', 'language', 'location', 'operation_type', 'property_type', 'price', 'currency', 'bedrooms', 'bathrooms', 'square_meters', 'updated_at'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'price': {'type': ['number', 'null']}, 'title': {'type': 'string'}, 'country': {'enum': ['PTY', 'DOM'], 'type': 'string'}, 'summary': {'type': 'string'}, 'bedrooms': {'type': ['number', 'null']}, 'currency': {'type': ['string', 'null']}, 'language': {'enum': ['es', 'en', 'it'], 'type': 'string'}, 'location': {'type': ['string', 'null']}, 'bathrooms': {'type': ['number', 'null']}, 'image_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'updated_at': {'type': ['string', 'null']}, 'property_id': {'type': 'string', 'format': 'uuid'}, 'property_type': {'type': ['string', 'null']}, 'square_meters': {'type': ['number', 'null']}, 'operation_type': {'enum': ['SALE', 'RENT', 'SALE_AND_RENT'], 'type': 'string', 'description': 'Published availability; SALE_AND_RENT satisfies either a sale or rent search.'}}, 'additionalProperties': False}}, 'has_more': {'type': 'boolean'}}, 'additionalProperties': False}
Added
get_guide_section
Sept. 17, 2026, 12:34 p.m.
Added
search_guides
Sept. 17, 2026, 12:34 p.m.
Added
get_property
Sept. 17, 2026, 12:34 p.m.
Added
search_properties
Sept. 17, 2026, 12:34 p.m.
Added
fetch
Sept. 17, 2026, 12:34 p.m.
Added
search
Sept. 17, 2026, 12:34 p.m.