Sava provides a read-only API and MCP endpoint for products, chatbots and research tools that need structured access to residential new-build projects in Portugal.
The dataset includes project names, locations, typologies, price and area ranges, completion year, developer when known, and estimated travel times to the beach and airport.
REST API
Use simple HTTP endpoints to search projects, open details by slug, list municipalities and fetch the OpenAPI specification.
Endpoint
https://sava.pt/api/v1/projects?municipality=Lisboa&typology=T2&max_price=700000&limit=3&locale=enEndpoint
https://sava.pt/api/v1/projects/1965-cidade-jardim?locale=enMCP
Use JSON-RPC at /api/mcp/ to expose the same operations to assistants and tool-compatible agents.
curl MCP
curl -X POST https://sava.pt/api/mcp/ \
-H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'OpenAPI
https://sava.pt/api/v1/openapi.json| Method | Path | Purpose | Parameters |
|---|---|---|---|
GET | /api/v1/projects | Search projects by filters. | municipality, locality, typology, property_type, min_price, max_price, min_area, max_area, completion_year, max_beach_drive_minutes, max_airport_drive_minutes, locale, limit |
GET | /api/v1/projects/{slug} | Get complete project details. | slug, locale |
GET | /api/v1/locations | List available municipalities. | limit |
GET | /api/v1/openapi.json | Fetch the OpenAPI specification. | - |
POST | /api/mcp/ | Call MCP tools via JSON-RPC. | tools/list, tools/call |