Una API abierta de inmuebles, pensada para agentes.

PropFácil ofrece una API pública y un servidor MCP para asistentes de IA. Buscar, abrir fichas y explorar el carrusel o mapa no requiere autenticación; administrar favoritos o publicar sí requiere vincular una cuenta.

Empieza en un curl

Casas en renta a 12 km del centro de Toluca, hasta $9,000, con 2+ recámaras:

curl "https://www.propfacil.com/api/v1/properties?\
  transactionType=ForLease&near=19.2926,-99.6569&radius=12000&\
  minBedrooms=2&maxPrice=9000&limit=3"

Endpoints

GET   /api/v1/properties           búsqueda (filtros + radio geográfico)
GET   /api/v1/properties/{key}     ficha completa (fotos, descripción, coords)
POST  /api/v1/properties           publicar (requiere OAuth · scope properties:write)

Acceso para agentes (OAuth 2.1)

Leer el catálogo es abierto; favoritos y publicación requieren autorización con OAuth 2.1 (compatible con clientes MCP). No hay API keys: el agente registra un cliente y obtiene un token con el flujo authorization_code + PKCE.

# 1. Descubre el servidor de autorización
GET  /.well-known/oauth-authorization-server
GET  /.well-known/oauth-protected-resource   ·   /.well-known/jwks.json

# 2. Registra un cliente (RFC 7591)
POST /api/oauth/register   { "client_name": "...", "redirect_uris": ["https://.../cb"] }

# 3. Autoriza (consentimiento del usuario) y canjea el código
GET  /oauth/authorize?client_id=...&redirect_uri=...&response_type=code&
       resource=https://www.propfacil.com/api/mcp&scope=lists:read%20lists:write&
       code_challenge=...&code_challenge_method=S256
POST /api/oauth/token      grant_type=authorization_code · resource=... · +refresh_token

# 4. Publica con el token
POST /api/v1/properties    Authorization: Bearer <access_token>

Al publicar, la propiedad entra en vivo pero pasa por revisiones automáticas; si alguna falla, responde 422 con los motivos y no se publica. Las fotos (URLs) se descargan y optimizan a WebP.

Servidor MCP

Endpoint universal https://www.propfacil.com/api/mcp (JSON-RPC, Streamable HTTP). La búsqueda, ficha y vista interactiva son públicas. Publicaciones propias y el CRUD de listas/favoritos usan OAuth. El recurso MCP Apps incluye carrusel, detalle, comparación y mapa fullscreen. Tarjeta y skills: server-card.json → · agent-skills →

Plugin actual y contrato REST heredado

El plugin actual se distribuye como paquete universal con un servidor MCP y una UI de resultados. La especificación OpenAPI y ai-plugin.json siguen disponibles solo para clientes heredados. Ver OpenAPI →

Modelo de datos

Alineado al RESO Data Dictionary: Property, Media, Member (anunciantes) y Office (agencias). Cada propiedad trae su procedencia y un nivel de confidence, que mide si los datos están completos, no si son ciertos. Lo que se publica en PropFácil pasa validaciones de formato y campos, que no verifican su veracidad. Los anuncios tomados de sitios públicos de terceros no se verifican.

El dataset experimental de adaptadores de terceros no forma parte de las respuestas del plugin público.