About PropFácil
PropFácil is a hosted MCP server for finding authorized real-estate listings in Mexico. It supports public search and property contacts, plus OAuth-protected favorites and listing management.
Key features
- 01Search listings by location and criteria
- 02View property details
- 03Retrieve contact and listing links
- 04Show cards, comparisons, and maps
- 05Manage favorites with OAuth
- 06View and publish user listings
Use cases
- 01Find properties by city, price, or bedrooms
- 02Get contact options for a property
- 03Organize saved property lists
- 04Manage linked property listings
MCP support
Exposes property search, details, contact options, favorites, and listing management to MCP clients over remote Streamable HTTP. OAuth is required for favorites and publishing; interactive displays depend on host MCP Apps support.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://www.propfacil.com/api/mcpclaude mcp add --transport http jonatanvazquez-propfacil https://www.propfacil.com/api/mcp{"mcpServers":{"jonatanvazquez-propfacil":{"type":"http","url":"https://www.propfacil.com/api/mcp"}}}Open in Cursor{"servers":{"jonatanvazquez-propfacil":{"type":"http","url":"https://www.propfacil.com/api/mcp"}}}Open in VS Code{"mcpServers":{"jonatanvazquez-propfacil":{"type":"http","url":"https://www.propfacil.com/api/mcp"}}}{"mcpServers":{"jonatanvazquez-propfacil":{"serverUrl":"https://www.propfacil.com/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
13| Parameter | Type | Required | Description |
|---|---|---|---|
| city | string | No | Mexican city or municipality name explicitly requested by the user. |
| near | string | No | Map center as lat,lng. Use only a location explicitly supplied by the user. |
| limit | integer | No | Maximum number of results to return. |
| radius | number | No | Search radius in meters. |
| maxPrice | number | No | Maximum listing price in the listing currency. |
| minPrice | number | No | Minimum listing price in the listing currency. |
| minBedrooms | integer | No | Minimum number of bedrooms. |
| transactionType | enum | No | Listing operation: ForSale to buy or ForLease to rent.ForSale | ForLease |
Details
From the project README
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
{
"mcpServers": {
"propfacil": {
"type": "http",
"url": "https://www.propfacil.com/api/mcp"
}
}
}
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.