# PropFácil [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/jonatanvazquez/propfacil-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/propf-cil

## Description
Search authorized real estate in Mexico and manage favorites and publishing with OAuth.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "propf-cil": {
    "command": "npx",
    "args": ["-y","propf-cil"]
  }
}
```

## Documentation & README

<!-- mcp-name: io.github.jonatanvazquez/propfacil -->

<p align="center">
  <img src="https://raw.githubusercontent.com/jonatanvazquez/propfacil-mcp/HEAD/assets/propfacil-icon-512.png" width="144" height="144" alt="PropFácil">
</p>

# PropFácil MCP

[![Validate distribution](https://github.com/jonatanvazquez/propfacil-mcp/actions/workflows/validate.yml/badge.svg)](https://github.com/jonatanvazquez/propfacil-mcp/actions/workflows/validate.yml)

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.

> [Leer en español](https://github.com/jonatanvazquez/propfacil-mcp/blob/HEAD/README.es.md)

## 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`

```json
{
  "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](https://github.com/jonatanvazquez/propfacil-mcp/blob/HEAD/docs/installation.md) 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](https://github.com/jonatanvazquez/propfacil-mcp/blob/HEAD/docs/tools.md) and [authentication details](https://github.com/jonatanvazquez/propfacil-mcp/blob/HEAD/docs/authentication.md).

## 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`](https://github.com/jonatanvazquez/propfacil-mcp/blob/HEAD/server.json)
- Official MCP Registry status: [`io.github.jonatanvazquez/propfacil` 1.3.9](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.jonatanvazquez%2Fpropfacil)
- Smithery listing: [`jonatan/propfacil`](https://smithery.ai/servers/jonatan/propfacil)
- GitHub release: [`v1.3.9`](https://github.com/jonatanvazquez/propfacil-mcp/releases/tag/v1.3.9)
- Generic client configuration: [`.mcp.json`](https://github.com/jonatanvazquez/propfacil-mcp/blob/HEAD/.mcp.json)
- Agent-readable installer guidance: [`llms-install.md`](https://github.com/jonatanvazquez/propfacil-mcp/blob/HEAD/llms-install.md)
- Reusable directory listing fields: [`directory-profile.json`](https://github.com/jonatanvazquez/propfacil-mcp/blob/HEAD/directory-profile.json)
- Launch runbook: [`docs/launch-runbook.md`](https://github.com/jonatanvazquez/propfacil-mcp/blob/HEAD/docs/launch-runbook.md)
- Directory-specific notes: [`docs/directory-submissions.md`](https://github.com/jonatanvazquez/propfacil-mcp/blob/HEAD/docs/directory-submissions.md)
- Cline Marketplace submission: [issue #2287](https://github.com/cline/mcp-marketplace/issues/2287)

## Policies and support

- [Privacy policy](https://www.propfacil.com/privacidad)
- [Terms of service](https://www.propfacil.com/terminos)
- [Support](https://www.propfacil.com/soporte)
- [Security policy](https://github.com/jonatanvazquez/propfacil-mcp/blob/HEAD/SECURITY.md)

Metadata, configuration examples and documentation are available under the [MIT License](https://github.com/jonatanvazquez/propfacil-mcp/blob/HEAD/LICENSE).
The PropFácil name and logo are excluded from that license; see [TRADEMARKS.md](https://github.com/jonatanvazquez/propfacil-mcp/blob/HEAD/TRADEMARKS.md).