AVENAMCP SERVER

Avena Terminal MCP Server

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 regionsavg score 50/100avg yield 3.7%

Quick Start

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

POST https://avenaterminal.com/mcp

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

Available Tools

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).

ref required — Property reference ID
get_market_statsread-only

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

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.

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.

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.

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.

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.

Data Coverage

1,881
Properties
100
Towns
10
Regions
2
Developers

Investment Score Model

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

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

Kolstad, H. (2026). Spain New Build Property Investment Dataset.

Avena Terminal. DOI: 10.5281/zenodo.19520064

https://avenaterminal.com