◇ Protocolo abierto · alineado a RESO

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.

REST / JSON

Búsqueda por precio, tipo, recámaras y radio geográfico. Respuestas con forma RESO.

RESO Web API

Capa OData (/Property) con los nombres del Data Dictionary, para integrar con sistemas RESO.

Agentes (MCP)

Un servidor MCP universal expone herramientas compatibles con ChatGPT, Codex y otros clientes MCP.

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 confianza — nada entra sin pasar las validaciones de calidad.

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