PropFácil README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the PropFácil listing page.
PropFácil MCP
Remote Model Context Protocol server for finding authorized real-estate listings in Mexico. It provides public property search, details and contact options, plus OAuth-protected favorites and publishing tools.
Connect
- MCP endpoint:
https://www.propfacil.com/api/mcp - Transport: Streamable HTTP
- Current version:
1.3.9 - Server card:
https://www.propfacil.com/.well-known/mcp/server-card.json - Documentation:
https://www.propfacil.com/docs
This is a hosted server. Do not clone this repository to run it locally and do not request an API key. Clients that support MCP OAuth start the account-linking flow automatically when a protected tool is used.
See installation instructions for ChatGPT, Codex, Cline and generic clients.
Capabilities
| Capability | Authentication |
|---|---|
| Search authorized listings by city, price, bedrooms, transaction type or radius | Public |
| Open a property record | Public |
| Retrieve authorized phone, WhatsApp or original-listing links for one property | Public |
| Render cards, comparison and map in MCP Apps-compatible hosts | Public |
| List and inspect favorite lists | OAuth |
| Save, rename, remove from or delete favorite lists | OAuth |
| View and publish the linked user's listings | OAuth |
The server exposes twelve model-visible tools plus one private UI restoration tool. See the complete tool reference and authentication details.
Host compatibility
All MCP clients can consume the tools and structured results when they support remote Streamable HTTP. The interactive cards and map require a host with MCP Apps UI support; clients without that UI still receive normal structured data. Protected tools additionally require a client that supports MCP OAuth.
Distribution
This repository contains public distribution metadata, installation instructions and brand assets for the hosted PropFácil MCP server. The production backend is maintained separately.
- Official MCP Registry metadata:
server.json - Official MCP Registry status:
io.github.jonatanvazquez/propfacil1.3.9 - Smithery listing:
jonatan/propfacil - GitHub release:
v1.3.9 - Generic client configuration:
.mcp.json - Agent-readable installer guidance:
llms-install.md - Reusable directory listing fields:
directory-profile.json - Launch runbook:
docs/launch-runbook.md - Directory-specific notes:
docs/directory-submissions.md - Cline Marketplace submission: issue #2287
Policies and support
Metadata, configuration examples and documentation are available under the MIT License. The PropFácil name and logo are excluded from that license; see TRADEMARKS.md.