# Mashvisor MCP

> Mashvisor analyzes real estate investments, letting you compare Airbnb short-term rental ROI against traditional long-term rentals using AI. You can search for properties by location and criteria, calculate cash-on-cash returns, view occupancy rates, and analyze neighborhood demand indicators—all through natural language prompts.

## Overview
- **Category:** real-estate
- **Price:** Free
- **Tags:** investment-analysis, rental-yield, property-data, market-insights, airbnb-analytics, roi-calculation

## Description

This server connects Mashvisor's full real estate analytics suite directly to your agent. You can run deep investment models against any potential property, pitting short-term Airbnb income right up against traditional long-term leases.

You don't just get a price; you get the whole market context—including historical performance trends over years. The tools let you sift through data and compare how different types of properties perform in the same area. You can find investment opportunities quickly by using `search_properties` and `list_properties`, filtering results across city, state, price range, and bedroom count to narrow down exactly what you need.

To get a broad view of an entire metro area, run `get_city_listings`. This pulls market listings filtered by attributes like historical price changes and days on market. For a deeper dive into the specifics of a single asset, use `get_property` to retrieve its core details, or pull granular data points for verification using `get_airbnb_property`.

When you're ready to crunch numbers, the server handles all the financial heavy lifting. You run `get_investment_analysis` on any property; it calculates key metrics like cap rates and cash-on-cash returns for both short-term and long-term strategies. To look at past performance—which is crucial for predicting seasonality and sustained revenue patterns—you use `get_historical_performance`. This analyzes deep, past Airbnb data to give you a better idea of what's coming.

For local comparisons, the server gives you two ways to view neighborhood potential. You can run `list_neighborhoods` to compare investment metrics across several areas within one city market, or use `get_airbnb_listings` for current performance metrics and associated data in a specific target zone. If you're looking at standard income streams, `get_rental_rates` estimates typical long-term rental rates for properties ranging from 1 to 5 bedrooms using local rent distribution stats.

When you need to focus only on Airbnb potential, `get_airbnb_listings` pulls current listings and their associated performance metrics. You can also pull specific data for an existing listing with `get_airbnb_property` to view key metrics like occupancy rates, average daily rate (ADR), and projected monthly revenue. The entire system lets you compare the two major paths: high-yield short-term rentals versus stable long-term leases.

You don't have to manually check every corner of a city; `list_properties` handles filtering the database by location, bedroom count, and type, returning listings that already include both Airbnb and LTR metrics. You can also get a general sense of what’s available using `get_city_listings`, which pulls market-wide data points like price history and days on market across the city.

This entire stack means your agent executes complex commands—like asking to compare 3-bedroom properties in Manhattan vs. Brooklyn, calculating potential cash returns for both STR and LTR for each one, and checking historical occupancy rates for all of them. The server processes all that information and sends back structured data ready for your AI client to read and summarize.

## Tools

### get_airbnb_listings
Retrieves current Airbnb rental listings and associated performance metrics for a target area.

### get_airbnb_property
Pulls detailed, granular data points on a specific Airbnb listing to verify its market potential.

### get_city_listings
Gets city-wide market listings by filtering attributes like price history and days on market.

### get_historical_performance
Analyzes past Airbnb data, helping predict seasonality and long-term revenue patterns for a property or area.

### get_investment_analysis
Runs a full investment analysis on a property to calculate key metrics like cap rates and cash returns.

### get_property
Retrieves core, detailed information about a specific real estate asset beyond just the market data.

### get_rental_rates
Estimates standard long-term rental rates for properties with 1 to 5 bedrooms using local rent distribution statistics.

### list_neighborhoods
Provides investment metrics and comparative data across multiple neighborhoods within a single city market.

### list_properties
Filters the property database by location, bedroom count, and type, returning listings with both Airbnb and LTR metrics.

### search_properties
Performs advanced searches across properties using multiple filters to narrow down viable investment assets quickly.

## Prompt Examples

**Prompt:** 
```
Show me investment properties in Las Vegas with good Airbnb ROI.
```

**Response:** 
```
Found 15 properties in Las Vegas. Top pick: 3BR/2BA Single Family at $435K with 11.2% cash-on-cash return on Airbnb (73% occupancy, $188/night, $4,124/mo revenue). Traditional rental would yield 5.3% CoC at $2,100/mo.
```

**Prompt:** 
```
What's the best neighborhood for Airbnb in Chicago?
```

**Response:** 
```
Top neighborhoods in Chicago by Airbnb ROI: 1) Logan Square — 8.9% ROI, avg $2,800/mo revenue, 71% occupancy. 2) Wicker Park — 8.2% ROI, $3,100/mo, 68% occupancy. 3) Lincoln Park — 7.5% ROI, $3,400/mo, 65% occupancy.
```

**Prompt:** 
```
What are typical rental rates for a 3BR in Austin, TX?
```

**Response:** 
```
Austin, TX rental estimates: 1BR: $1,400/mo | 2BR: $1,750/mo | 3BR: $2,100/mo | 4BR: $2,600/mo | 5BR: $3,200/mo. The 3BR average is based on 1,200+ comparable rentals in the area.
```

## Capabilities

### Find Properties by Criteria
Use filters (city, bedrooms, price) to retrieve a list of properties with both Airbnb and long-term rental metrics.

### Calculate Investment Returns
Get detailed financial analysis including cap rates and cash-on-cash returns for both short-term and long-term strategies.

### Analyze Airbnb Performance
View key metrics like occupancy rate, average daily rate, and monthly revenue projections for specific listings or periods.

### Compare Local Neighborhoods
Get comparative investment data across different neighborhoods based on ROI potential and market demand.

### Estimate Traditional Rent
Retrieve typical long-term rental rate estimates for properties ranging from 1 to 5 bedrooms.

## Use Cases

### Analyzing an Entire Zip Code
A flipper needs to know if a whole zip code is viable. They ask their agent to use `list_neighborhoods` first, which ranks the areas by ROI. Then, they run `get_city_listings` on the top two neighborhoods to see active market listings and decide where to focus their physical search.

### Validating a Single Deal
A potential buyer finds an address online. They send it to their agent with a prompt, which triggers `get_investment_analysis`. The tool returns the cap rate and cash-on-cash return for both Airbnb and traditional rent, allowing them to immediately decide if the deal makes sense.

### Comparing Property Types
You are comparing a 2BR vs. a 3BR in Austin. Instead of guessing rates, you ask your agent to use `get_rental_rates`. This gives you structured estimates for both sizes based on comparable local rentals, giving you solid numbers to work with.

### Spotting Market Trends
You're interested in a property but aren't sure about the current market cycle. You use `get_historical_performance` to see how Airbnb occupancy and revenue have trended over the last three years, revealing if you're buying at a peak or trough.

## Benefits

- You stop guessing. Instead of just seeing a price, you use `get_investment_analysis` to get hard metrics like cap rates and cash-on-cash returns for both short-term (STR) and long-term (LTR) strategies. It gives you the full financial picture.
- Time is money. Running basic searches with `list_properties` lets you filter by city, state, price, and bedrooms. You get a list of candidates that already include vital metrics for both Airbnb and traditional rent.
- Seasonality isn't a guess anymore. By running `get_historical_performance`, you analyze up to 36 months of data. This shows you when the market is strong and when it dips, so your revenue forecast isn't based on optimism.
- Neighborhood comparison gets deep. The `list_neighborhoods` tool allows you to compare multiple areas side-by-side using key indicators like ROI potential and demand benchmarks—you see which area holds the most value.
- You get a full picture of rent options. You can use `get_rental_rates` to establish a baseline for traditional income, while simultaneously running `get_airbnb_listings` to model the higher revenue stream from short-term stays.

## How It Works

The bottom line is that you talk to your AI client like a human analyst talks to an intern; it pulls all the hard numbers for you.

1. Subscribe to the server and input your Mashvisor API Key.
2. Instruct your AI client with a specific real estate query (e.g., 'Compare STR vs LTR for this address').
3. The MCP Server executes multiple tools, processes the raw data, and returns structured investment metrics that your agent can interpret.

## Frequently Asked Questions

**How do I get a Mashvisor API Key?**
Sign up at [**Mashvisor**](https://www.mashvisor.com/), go to your account settings, and generate an API key. API access requires an active subscription.

**What investment metrics are available?**
Cap rate, cash-on-cash return, occupancy rate, average daily rate (ADR), monthly/annual revenue, RevPAR, and rental rates for both Airbnb (STR) and traditional (LTR) strategies.

**Can I compare Airbnb vs traditional rental income?**
Yes! Every property analysis includes both STR (Airbnb) and LTR (traditional) metrics side by side, including cap rates and cash-on-cash returns for each strategy.

**How do I use the `list_properties` tool to filter for specific city or state combinations?**
You pass the target city, state, and minimum/maximum bedroom count directly to the tool. The function returns a list of properties that match those criteria, including both Airbnb and long-term rental metrics for each one.

**What data does `list_neighborhoods` provide regarding investment potential?**
The tool gives you market benchmarks and specific ROI data for various neighborhoods. You can compare areas based on demand indicators, helping pinpoint which micro-market yields the best return.

**Can I use `get_historical_performance` to analyze seasonal trends?**
Yes, you set a time window of up to 36 months for the analysis. This data shows how Airbnb performance changes over time—for instance, identifying typical low seasons or peak booking periods.

**What types of listings can I access using `get_city_listings`?**
`get_city_listings` lets you filter by listing status. You can search for active properties, distressed assets, or even off-market listings that aren't currently advertised.

**If I have a specific property ID, how do I use `get_property`?**
Providing the unique property identifier to `get_property` retrieves all detailed information for that listing. This includes size, current price, and deep feature details about the asset.