MCP and REST compared
Casafari's data can be reached two ways: the MCP server at https://mcp.casafari.com/ and the REST API at https://api.casafari.com. They overlap, but neither contains the other. This page lines them up product by product. It is generated from the tool definitions and from the public OpenAPI description, so it changes when either does.
How to read it. Equivalent means the same operation is offered over both interfaces. Related means the two do part of the same job in different ways, so neither replaces the other. A dash means the other interface has nothing for it. "REST" here is the public OpenAPI description; your account's own specification at docs.api.casafari.com may list more.
By product
| Product | MCP tools | REST operations | Linked tools | Linked operations | Available over |
|---|---|---|---|---|---|
| Properties | 0 | 5 | 0 | 0 | REST only |
| Comparables & Valuation | 1 | 4 | 1 | 3 | Both |
| Area Insights | 8 | 6 | 5 | 4 | Both |
| Alerts | 0 | 12 | 0 | 0 | REST only |
| References | 0 | 10 | 0 | 1 | REST only |
| AgentGraph AI | 13 | 0 | 0 | 0 | MCP only |
| Total | 22 | 37 | 6 | 8 |
The gateway's own tool, list_servers, has no REST counterpart: there is no gateway over REST. Sign-in operations (POST /login, GET /refresh-token) belong to no product and are described in REST API; MCP signs in with OAuth instead (Authentication).
Gaps
Only over MCP
- Area Insights:
ma_get_current_datetime,ma_get_time_series_operations,ma_get_heatmap. - AgentGraph AI: all 13 tools.
Only over REST
- Properties: all 5 operations.
- Comparables & Valuation:
POST /api/v2/comparables/ai-builder. - Area Insights:
POST /market-analytics-api/distributions/properties,POST /market-analytics-api/analysis. - Alerts: all 12 operations.
- References:
GET /api/v1/references/agencies,GET /api/v1/references/agents,GET /api/v1/references/conditions,GET /api/v1/references/features,POST /api/v1/references/locations,GET /api/v1/references/locations/by-coordinates,GET /api/v1/references/sources,GET /api/v1/references/types,POST /api/v1/references/zipcode-boundary.
Product by product
Properties
Over MCP: 0 tools. Over REST: 5 operations. Available over REST only. Properties. MCP has no tool for Properties.
Comparables & Valuation
Over MCP: 1 tool. Over REST: 4 operations. Available over both. Comparables & Valuation.
| MCP tool | REST operation | How they relate |
|---|---|---|
comps_get-comparables | POST /api/v2/comparables/search | Equivalent. 26 request fields in common; REST only: coordinates, target_point, distance, business_type, comparables_type, property_type, floor, view, 3 more. |
comps_get-comparables | POST /api/v1/comparables/search | Related. The v1 version of the comparables search. |
comps_get-comparables | POST /api/v1/valuation/comparables-prices | Related. The tool's response includes estimated price ranges; REST returns estimated prices from this separate operation. |
| — | POST /api/v2/comparables/ai-builder | Only over REST |
Area Insights
Over MCP: 8 tools. Over REST: 6 operations. Available over both. Area Insights.
| MCP tool | REST operation | How they relate |
|---|---|---|
ma_get_current_datetime | — | Only over MCP |
ma_get_time_series_data | POST /market-analytics-api/time-series | Equivalent. 19 request fields in common; REST only: types; MCP only: type_group, alias. |
ma_get_time_series_operations | — | Only over MCP |
ma_get_price_distribution | POST /market-analytics-api/distributions/prices | Equivalent. 16 request fields in common; REST only: types; MCP only: type_group. |
ma_get_bedrooms_distribution | POST /market-analytics-api/distributions/bedrooms | Equivalent. 16 request fields in common; REST only: types; MCP only: type_group. |
ma_get_time_on_market_distribution | POST /market-analytics-api/distributions/time-on-market | Equivalent. 17 request fields in common; REST only: types; MCP only: type_group. |
ma_get_heatmap | — | Only over MCP |
ma_get_location_typeahead | POST /api/v1/references/locations/typeahead | Related. In References. Both turn a place name into location ids. The MCP tool takes an English name; REST takes country_codes (ES or PT) and a response lang. |
| — | POST /market-analytics-api/distributions/properties | Only over REST |
| — | POST /market-analytics-api/analysis | Only over REST |
Alerts
Over MCP: 0 tools. Over REST: 12 operations. Available over REST only. Alerts. MCP has no tool for Alerts.
References
Over MCP: 0 tools. Over REST: 10 operations. Available over REST only. References. MCP has no tool for References, except where a tool of another product covers one operation (below).
| MCP tool | REST operation | How they relate |
|---|---|---|
| — | GET /api/v1/references/agencies | Only over REST |
| — | GET /api/v1/references/agents | Only over REST |
| — | GET /api/v1/references/conditions | Only over REST |
| — | GET /api/v1/references/features | Only over REST |
| — | POST /api/v1/references/locations | Only over REST |
| — | GET /api/v1/references/locations/by-coordinates | Only over REST |
ma_get_location_typeahead | POST /api/v1/references/locations/typeahead | Related. In Area Insights. Both turn a place name into location ids. The MCP tool takes an English name; REST takes country_codes (ES or PT) and a response lang. |
| — | GET /api/v1/references/sources | Only over REST |
| — | GET /api/v1/references/types | Only over REST |
| — | POST /api/v1/references/zipcode-boundary | Only over REST |
AgentGraph AI
Over MCP: 13 tools. Over REST: 0 operations. Available over MCP only. AgentGraph AI. The public REST description has no operation for AgentGraph AI, so all 13 tools can be reached over MCP only.
Questions about this
- What is the difference between Casafari MCP and the Casafari REST API?
- Which products does Casafari MCP offer, and how many tools are there?
- Can I search properties over Casafari MCP?
- Can I get alerts (new properties, price cuts, sales) over Casafari MCP?
- Which tools exist only over MCP, and which operations only over REST?