A
AvenaTerminal · Est. 2026
Protocol · MCP Server

Property data,
native to AI.

Connect your AI assistant to live investment-scored data for 1,881 new build properties across Spain. Free. No authentication required.

1,881 Properties100 Towns10 Regions50/100 Avg score3.7% Avg yield
Quick Start

Paste into config.

Add Avena Terminal to your Claude Desktop configuration:

// claude_desktop_config.json
{
  "mcpServers": {
    "avena-terminal": {
      "url": "https://avenaterminal.com/mcp"
    }
  }
}

Or for clients that require explicit transport:

{
  "mcpServers": {
    "avena-terminal": {
      "url": "https://avenaterminal.com/mcp",
      "transport": "http"
    }
  }
}
Endpoint

One URL.

POST https://avenaterminal.com/mcp

Transport: Streamable HTTP · Auth: None (public read-only) · Protocol: MCP 2025-03-26

Tools

Available capabilities.

search_propertiesread-only

Search 1,881 scored new build properties. Filter by region, price, score, type, bedrooms. Returns ranked results with scores, yields, and pricing data.

Parameters
region string, optional — costa-blanca, costa-calida, costa-del-sol
max_price number, optional — Maximum price in EUR
min_score number, optional — Minimum investment score (0-100)
type string, optional — Villa, Apartment, Penthouse, Townhouse, Bungalow, Studio
min_beds number, optional — Minimum bedrooms
limit number, optional — Results count (default 10, max 25)
Example response
{
  "total_matching": 342,
  "showing": 3,
  "source": "Avena Terminal (avenaterminal.com)",
  "properties": [
    {
      "ref": "AP1-CB-12345",
      "name": "Villa in Torrevieja, Alicante",
      "type": "Villa",
      "price": 249000,
      "score": 82,
      "yield_gross": 7.2,
      "price_per_m2": 2180,
      "beach_km": 1.5,
      "bedrooms": 3,
      "developer": "Premium Homes"
    }
  ]
}
get_propertyread-only

Full property details with investment score breakdown (value, yield, location, quality, risk components).

Parameters
ref required — Property reference ID
get_market_statsread-only

Live market statistics: median price/m2, average yields, inventory counts, top towns, and regional breakdowns.

Parameters
region string, optional — costa-blanca, costa-calida, costa-del-sol, or "all"
get_top_dealsread-only

Today's best investment opportunities ranked by composite score with human-readable reasoning and multi-currency pricing.

Parameters
region string, optional — Region filter
limit number, optional — Number of deals (default 5, max 15)
max_price number, optional — Maximum price in EUR
estimate_roiread-only

Project ROI over a holding period. Includes capital appreciation, rental income, buying costs, and annualized return in EUR/GBP/NOK/SEK/USD.

Parameters
ref required — Property reference ID
hold_years number, optional — Holding period (default 5, max 20)
compare_alternativesread-only

Find similar properties to compare against a listing. Returns alternatives with score and price differentials.

Parameters
ref required — Property reference ID to compare
limit number, optional — Alternatives count (default 5, max 10)
market_timingread-only

Market timing indicators: phase assessment (buyer's/seller's/neutral), discount analysis, inventory levels, and actionable recommendation.

Parameters
region string, optional — costa-blanca, costa-calida, costa-del-sol, or "all"
search_properties_portugalcoming Q3 2026

Search scored new build properties across Portugal's Algarve, Lisbon Coast, and Silver Coast.

Coverage

The footprint.

1,881
Properties
100
Towns
10
Regions
2
Developers
Investment Score Model

Five weighted factors.

Every property receives a composite score from 0–100 based on five weighted factors:

FactorWeight
Price vs Market (discount coefficient)40%
Rental Yield Potential (gross & net)25%
Location Quality (beach, amenities)20%
Build Quality (energy, pool, parking)10%
Completion Risk (timeline, developer)5%
Use cases

Build with it.

AI Property Assistant

Build a chatbot that answers questions about Spanish new builds with live scored data.

Investment Analysis

Let your AI agent compare regions, analyze yields, and find underpriced properties.

Market Research

Pull aggregate statistics for reports, dashboards, or academic research.

Portfolio Screening

Screen properties against criteria and get ranked recommendations.

Citation

Cite properly.

Kolstad, H. (2026). Spain New Build Property Investment Dataset.
Avena Terminal. DOI: 10.5281/zenodo.19520064
https://avenaterminal.com

First MCP server for European real estate

© 2026 Avena Terminal · avenaterminal.com