{
  "name": "avena-terminal",
  "version": "1.1.0",
  "description": "Avena Terminal MCP Server — Live investment-scored data for 1,881 new build properties across Costa Blanca, Costa Calida, and Costa del Sol, Spain. Search, filter, analyze, estimate ROI, compare alternatives, and assess market timing. Multi-currency responses (EUR/GBP/NOK/SEK/USD).",
  "url": "https://avenaterminal.com/mcp",
  "transport": "streamable-http",
  "authentication": "none",
  "documentation": "https://avenaterminal.com/mcp-server",
  "publisher": {
    "name": "Avena Terminal",
    "url": "https://avenaterminal.com",
    "contact": "henrik@xaviaestate.com"
  },
  "tools": [
    {
      "name": "search_properties",
      "description": "Search 1,881 scored new build properties in Spain. Returns investment-ranked results with composite score, score reasoning, yield estimate, multi-currency pricing (EUR/GBP/NOK/SEK/USD), beach distance, and developer info.",
      "parameters": {
        "region": { "type": "string", "description": "Region: costa-blanca, costa-calida, costa-del-sol, or town name", "required": false },
        "max_price": { "type": "number", "description": "Maximum price in EUR", "required": false },
        "min_score": { "type": "number", "description": "Minimum investment score (0-100)", "required": false },
        "type": { "type": "string", "description": "Villa, Apartment, Penthouse, Townhouse, Bungalow, Studio", "required": false },
        "min_beds": { "type": "number", "description": "Minimum bedrooms", "required": false },
        "limit": { "type": "number", "description": "Results count (default 10, max 25)", "required": false }
      }
    },
    {
      "name": "get_property",
      "description": "Full property details with investment score breakdown, human-readable score reasoning, and multi-currency pricing.",
      "parameters": {
        "ref": { "type": "string", "description": "Property reference ID", "required": true }
      }
    },
    {
      "name": "get_market_stats",
      "description": "Live market statistics: median price/m2, average yields, inventory counts, top towns, regional breakdowns.",
      "parameters": {
        "region": { "type": "string", "description": "costa-blanca, costa-calida, costa-del-sol, or all", "required": false }
      }
    },
    {
      "name": "get_top_deals",
      "description": "Today's best investment opportunities ranked by composite score with reasoning and multi-currency pricing.",
      "parameters": {
        "region": { "type": "string", "description": "Region filter", "required": false },
        "limit": { "type": "number", "description": "Number of deals (default 5, max 15)", "required": false },
        "max_price": { "type": "number", "description": "Maximum price in EUR", "required": false }
      }
    },
    {
      "name": "estimate_roi",
      "description": "Project ROI for a property over a holding period. Includes capital appreciation, rental income, buying costs, and annualized return in EUR/GBP/NOK/SEK/USD.",
      "parameters": {
        "ref": { "type": "string", "description": "Property reference ID", "required": true },
        "hold_years": { "type": "number", "description": "Holding period in years (default 5, max 20)", "required": false }
      }
    },
    {
      "name": "compare_alternatives",
      "description": "Find similar properties to compare against a specific listing. Returns alternatives in the same price bracket with score and price differentials.",
      "parameters": {
        "ref": { "type": "string", "description": "Property reference ID to compare", "required": true },
        "limit": { "type": "number", "description": "Number of alternatives (default 5, max 10)", "required": false }
      }
    },
    {
      "name": "market_timing",
      "description": "Market timing indicators: phase assessment (buyer's/seller's/neutral), discount analysis, inventory levels, and actionable recommendation.",
      "parameters": {
        "region": { "type": "string", "description": "costa-blanca, costa-calida, costa-del-sol, or all", "required": false }
      }
    }
  ],
  "coming_soon": [
    {
      "name": "search_properties_portugal",
      "description": "Search scored new build properties across Portugal's Algarve, Lisbon Coast, and Silver Coast. Coming Q3 2026.",
      "status": "planned"
    },
    {
      "name": "get_market_stats_portugal",
      "description": "Live market statistics for Portuguese new build regions. Coming Q3 2026.",
      "status": "planned"
    }
  ]
}