# avena-terminal

Live investment-scored data for 1,881 new build properties across Spain. Search by region, price, score, bedrooms. Returns ranked results with score reasoning, yields, and multi-currency pricing. Fir…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add henrik-kmvv/avena-terminal

# Browse available tools
npx -y @smithery/cli@latest tool list henrik-kmvv/avena-terminal

# Get full schema for a tool
npx -y @smithery/cli@latest tool get henrik-kmvv/avena-terminal search_properties

# Call a tool
npx -y @smithery/cli@latest tool call henrik-kmvv/avena-terminal search_properties '{}'
```

## Direct MCP Connection

Endpoint: `https://avena-terminal--henrik-kmvv.run.tools`

## Tools (7)

- `search_properties` — Search Avena Terminal's database of 1,881 scored new build properties in Spain. Returns investment-ranked results filte…
- `get_property` — Get full details and investment score breakdown for a specific property by its reference ID. Returns price analysis in …
- `get_market_stats` — Get live market statistics for Spanish new build regions. Returns median price per m2, average rental yield, total acti…
- `get_top_deals` — Get today's top-scoring new build property deals in Spain, ranked by Avena Terminal's composite investment score. Retur…
- `estimate_roi` — Estimate return on investment for a Spanish new build property over a specified holding period. Projects total return i…
- `compare_alternatives` — Find similar properties to compare against a specific listing. Returns N alternative properties with higher or lower sc…
- `market_timing` — Get market timing indicators for a Spanish new build region. Returns inventory levels, pricing trends, score distributi…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get henrik-kmvv/avena-terminal <tool-name>
```