MCP frente a REST API: cuál elegir
Respuesta corta: utilice los servidores MCP cuando la labor la realice un asistente de IA o agente (que descubre las herramientas, lee sus descripciones y las invoca por usted); utilice la REST API cuando la realice su propio código (peticiones fijas, su propia aplicación, tareas masivas).
Se puede acceder a los datos de Casafari de dos formas: mediante los servidores MCP, uno por producto en https://platform.casafari.com/mcp/, o mediante la REST API de la plataforma en https://platform.casafari.com/v1/<product>, ambos con la misma API key de plataforma o el mismo inicio de sesión OAuth y los mismos tokens. Se solapan, pero ninguno contiene al otro. Esta página los alinea producto por producto. Se genera a partir de las definiciones de herramientas y de los archivos OpenAPI propios de la plataforma, por lo que cambia cuando cualquiera de ellos lo hace: en la plataforma, una herramienta y una operación que realizan la misma tarea comparten un ID de operación, y así es como se encuentran las parejas que aparecen a continuación.
Cómo leerlo. Equivalente significa que la misma operación se ofrece a través de ambas interfaces. Relacionado indica que ambas desempeñan parte del mismo trabajo de formas distintas, por lo que ninguna sustituye a la otra. Un guion significa que la otra interfaz no dispone de nada al respecto. "REST" aquí es la API REST de la plataforma. Las rutas antiguas en https://api.casafari.com (clientes con contrato) se encuentran en la página de Legacy API, cada una con su equivalente en la plataforma.
Por producto
| Producto | Herramientas MCP | Operaciones REST | Herramientas vinculadas | Operaciones vinculadas | Disponible a través de |
|---|---|---|---|---|---|
| Property Sourcing | 5 | 5 | 5 | 5 | Ambos |
| High Potential Seller Leads | 0 | 2 | 0 | 0 | Solo REST |
| Private Seller Leads | 3 | 3 | 3 | 3 | Ambos |
| Comparables & Valuation | 1 | 1 | 1 | 1 | Ambos |
| Comparables with Transactions | 1 | 1 | 1 | 1 | Ambos |
| Area Insights | 10 | 10 | 8 | 8 | Ambos |
| Cadastre | 5 | 0 | 0 | 0 | Solo MCP |
| Parcel Zoning | 2 | 6 | 2 | 2 | Ambos |
| Total | 27 | 28 | 20 | 20 |
Location Lookup (/v1/locations, gratuito, el diccionario que utiliza cada producto) y las operaciones de cuenta y registro (/v1/account) no pertenecen a ningún producto; su parte MCP son locations_search, locations_get y account_status, disponibles en el servidor de cada producto. MCP inicia sesión con OAuth o con la misma clave de API de la plataforma (Autenticación). New Market Leads y Referencias todavía no tienen ni una herramienta MCP ni una ruta de plataforma.
Brechas
Solo mediante MCP
- Area Insights:
area-insights_get_current_datetime,area-insights_get_time_series_operations. - Cadastre: las 5 herramientas.
Solo mediante REST
- High Potential Seller Leads: las 2 operaciones (
GET /v1/seller-leads,GET /v1/seller-leads/{lead_id}). - Area Insights:
POST /v1/area-insights/analysis,POST /v1/area-insights/distributions/properties. - Parcel Zoning:
GET /v1/parcel-zoning/es/parcels,GET /v1/parcel-zoning/de/parcels/{cadastral_ref},GET /v1/parcel-zoning/de/parcels,GET /v1/parcel-zoning/health.
Producto a producto
Property Sourcing
Vía MCP: 5 herramientas. Vía REST: 5 operaciones. Disponible en ambas. Property Sourcing.
| Herramienta MCP | Operación REST | Cómo se relacionan |
|---|---|---|
property-sourcing_search | POST /v1/property-sourcing/searches | Equivalentes. 14 campos de solicitud en común. |
property-sourcing_next_page | GET /v1/property-sourcing/searches/{cursor} | Equivalent. |
property-sourcing_get_property | GET /v1/property-sourcing/properties/{property_id} | Equivalent. |
property-sourcing_resolve_listing | POST /v1/property-sourcing/properties/resolve | Equivalentes. 4 campos de solicitud en común. |
property-sourcing_get_closing_prices | GET /v1/property-sourcing/properties/{property_id}/closing-prices | Equivalent. |
High Potential Seller Leads
Mediante MCP: 0 herramientas. Mediante REST: 2 operaciones. Disponible solo en REST. High Potential Seller Leads. MCP no dispone de herramienta para High Potential Seller Leads.
Private Seller Leads
Mediante MCP: 3 herramientas. Mediante REST: 3 operaciones. Disponible en ambos. Private Seller Leads.
| Herramienta MCP | Operación REST | Cómo se relacionan |
|---|---|---|
private-sellers_search | POST /v1/private-sellers/search | Equivalentes. 8 campos de solicitud en común. |
private-sellers_get_listing | GET /v1/private-sellers/listings/{id} | Equivalent. |
private-sellers_coverage | GET /v1/private-sellers/coverage | Equivalent. |
Comparables & Valuation
Vía MCP: 1 herramienta. Vía REST: 1 operación. Disponible en ambas. Comparables & Valuation.
| Herramienta MCP | Operación REST | Cómo se relacionan |
|---|---|---|
comparables_get_comparables | POST /v1/comparables/search | Equivalentes. 26 campos de solicitud en común. |
Comparables with Transactions
Vía MCP: 1 herramienta. Vía REST: 1 operación. Disponible en ambos. Comparables with Transactions.
| Herramienta MCP | Operación REST | Cómo se relacionan |
|---|---|---|
comparables-transactions_get_comparables | POST /v1/comparables-transactions/search | Equivalentes. 26 campos de solicitud en común. |
Area Insights
Vía MCP: 10 herramientas. Vía REST: 10 operaciones. Disponible en ambas. Area Insights.
Cadastre
Vía MCP: 5 herramientas. Vía REST: 0 operaciones. Disponible solo en MCP. Cadastre. REST aún no cuenta con operaciones para Cadastre, por lo que las 5 herramientas solo pueden utilizarse vía MCP.
Parcel Zoning
Vía MCP: 2 herramientas. Vía REST: 6 operaciones. Disponible en ambos. Parcel Zoning.
| Herramienta MCP | Operación REST | Cómo se relacionan |
|---|---|---|
parcel-zoning_lookup | GET /v1/parcel-zoning/es/parcels/{cadastral_ref} | Equivalent. |
parcel-zoning_coverage | GET /v1/parcel-zoning/coverage | Equivalent. |
| — | GET /v1/parcel-zoning/es/parcels | Solo mediante REST |
| — | GET /v1/parcel-zoning/de/parcels/{cadastral_ref} | Solo mediante REST |
| — | GET /v1/parcel-zoning/de/parcels | Solo mediante REST |
| — | GET /v1/parcel-zoning/health | Solo mediante REST |
Claro AI
Claro AI es un producto de plataforma con su propio servidor MCP (https://platform.casafari.com/mcp/claro) y API REST (https://platform.casafari.com/v1/claro), independiente de los productos anteriores. Sus dos interfaces son equivalentes: 9 herramientas y 12 operaciones, además de 3 operaciones exclusivas de REST.
| Herramienta MCP | Operación REST | Cómo se relacionan |
|---|---|---|
search_premises | POST /v1/search | Equivalent. |
refine_search | POST /v1/search/refine | Equivalent. |
get_premises | GET /v1/premises/{id} | Equivalent. |
compare_premises | POST /v1/compare | Equivalent. |
explain_location | POST /v1/location | Equivalent. |
market_snapshot | POST /v1/market | Equivalent. |
brief_from_file | POST /v1/brief/file | Equivalente. En REST el archivo se envía como multipart; en MCP, al no admitir multipart, se envía codificado en base64 dentro de un JSON. |
search_plots | POST /v1/plots/search | Equivalente. Alemania, parcelas comerciales: solo parcelas, nunca locales. |
get_plot | GET /v1/plots/{id} | Equivalente. Alemania, parcelas comerciales. |
| — | PUT /v1/stores | Solo mediante REST |
| — | GET /v1/health | Solo mediante REST |
| — | POST /v1/search/ask | Solo mediante REST |