# Mashvisor Alternative MCP

> Mashvisor Alternative MCP Server provides real estate data, property searches, and investment analytics for AI agents. Use tools like `search_properties` or `get_property_comps` to pull full profiles, historical sales records, current rental rates, and neighborhood overviews directly into your workflow.

## Overview
- **Category:** real-estate
- **Price:** Free
- **Tags:** investment-analysis, property-search, rental-data, airbnb-analytics, market-intelligence

## Description

You're looking at the Mashvisor Alternative MCP Server, and it gives your AI client access to professional-grade real estate data, market analytics, and property investment metrics through simple tool calls. You use `search_properties` to run a programmatic search using specific criteria like minimum bedrooms, maximum price limits, or preferred locations across available listings.

For deep due diligence on any single address, you pull everything together with the `get_full_property_profile` tool; this action returns a complete data sheet including tax history records and Automated Valuation Model (AVM) estimates. You can check basic facts about a property—like how many beds it has or its square footage—by calling `get_property_details`. To estimate what the place is really worth, you run `get_property_comps`, which finds comparable properties that sold nearby to help establish a fair market value. Don't forget ownership records; you use `get_ownership_info` to identify the current owner and other key details tied to a property ID.

Tracking sales history is critical for due diligence, so you retrieve past transaction details using `get_historical_sales`, which shows exactly when and for how much a property sold. You can also validate if a city name works with `validate_city` before running broader lookups, or use `list_cities` to get a list of all valid cities within a specific state boundary.

When you're analyzing investment potential at the neighborhood level, you call `get_neighborhood_overview` for a detailed summary of an area, including key investment indicators. To find the best spots in a market, you use `get_top_neighborhoods`, which lists and ranks the highest-performing neighborhoods within your specified market zone. You can also get average long-term rental rates across a whole neighborhood or city using `get_rental_rates`. For broader analysis of an entire metropolitan area, `get_city_investment_performance` provides a summary of potential and key metrics for the whole city.

Short-term rentals require specific data. You pull current performance metrics for short-term rentals in either defined properties or entire areas using `get_airbnb_listings`. To analyze trend lines over time, you get 36 months of historical short-term rental (STR) performance data via `get_historical_performance`. For calculating potential income based on Airbnb metrics, use the specialized `rento_calculator_lookup` tool. You can also calculate local investment value by using `rento_calculator_lookup` in conjunction with other rate data.

For mapping out markets, you run `get_marketplace_listings` to search and return current available listings from the general real estate marketplace. You start your market investigation by running a comprehensive program search across all filters via `search_properties`. To get comparable property sales that help estimate value, use `get_property_comps`, which finds recent local transactions. If you want to gauge immediate rental potential, you can run specific metrics using the `rento_calculator_lookup` tool to determine what the area's earning power is.

## Tools

### get_airbnb_listings
Retrieves current short-term rental performance metrics for specific properties or areas.

### get_city_investment_performance
Provides a summary of investment potential and key metrics for an entire city.

### get_full_property_profile
Pulls a complete data sheet on one property, including tax history and AVM estimates.

### get_historical_sales
Retrieves a record of past transactions, showing when and for how much a property sold.

### get_ownership_info
Identifies the current owner and other key ownership details for any given property ID.

### get_property_comps
Finds comparable properties (comps) that sold nearby, helping estimate a fair market value.

### get_property_details
Gathers basic factual attributes about a property, like bed count and square footage.

### get_historical_performance
Gathers 36 months of historical short-term rental (STR) performance data for deep trend analysis.

### list_cities
Returns a list of valid cities within a given state boundary.

### get_marketplace_listings
Searches and returns current available listings from the general real estate marketplace.

### get_neighborhood_overview
Presents a detailed summary of a specific neighborhood, including investment indicators.

### get_rental_rates
Looks up the average long-term rental rates for a given neighborhood or city.

### rento_calculator_lookup
Performs specific Airbnb metric calculations to help determine rental potential.

### search_properties
Runs a programmatic search based on multiple filters (e.g., min beds, max price) across listings.

### get_top_neighborhoods
Lists and ranks the best performing neighborhoods in a specified market area.

### validate_city
Confirms if a provided city name is valid and usable for data lookups.

## Prompt Examples

**Prompt:** 
```
Search for properties in Miami, FL with at least 3 beds and a price under $600,000.
```

**Response:** 
```
I've found several properties in Miami matching your criteria. For example, a 3-bed property at [Address] is listed for $585,000. Would you like the full property profile for any of these?
```

**Prompt:** 
```
Get the full property profile and historical sales for property ID 123456.
```

**Response:** 
```
Fetching data for ID 123456... The profile includes a Mashvisor AVM of $450,000. Historical sales show it was last sold in 2018 for $310,000. It also has a tax history of $4,200 annually.
```

**Prompt:** 
```
What are the top neighborhoods for investment in Orlando, FL?
```

**Response:** 
```
Analyzing Orlando market... The top neighborhoods based on investment performance are 'Downtown' (Cash on Cash: 5.2%) and 'Lake Nona' (Cash on Cash: 4.8%). Would you like a detailed overview of 'Downtown'?
```

## Capabilities

### Search properties by filters
Uses specific criteria (beds, price, location) to find a list of available property listings.

### Run full due diligence reports
Retrieves comprehensive data—like tax history and transaction records—for a single property ID using `get_full_property_profile`.

### Calculate local investment potential
Gathers current long-term or short-term rental rates for an area, helping you gauge market value with `get_rental_rates`.

### Map out neighborhood performance
Gets detailed overviews and rankings of top local areas to help identify the best investment markets using `get_neighborhood_overview` or `get_top_neighborhoods`.

### Track property ownership and sales
Fetches records detailing who owns a property and its past sale history, which is critical for due diligence.

## Use Cases

### Vetting a new target city
An investor wants to know if Raleigh, NC, is worth buying into. Instead of spending days on Google, they ask their agent to first use `list_cities` to validate the market, then call `get_top_neighborhoods`. The agent returns a ranked list and summary data for the top areas, allowing the investor to narrow down the focus instantly.

### Analyzing a specific listing
A property manager is looking at a house. They ask their AI client to run a full check: first using `get_property_details` for basic specs, then calling `get_historical_sales` and `get_ownership_info`. This sequence provides a complete picture—the price history, the owner, and the physical attributes—all in one go.

### Optimizing short-term rentals
A landlord wants to maximize cash flow. They prompt their agent with the address and ask for performance data. The agent runs `get_airbnb_listings` and `get_historical_performance`, returning 36 months of STR metrics so they can accurately price the listing.

### Finding a profitable investment niche
An analyst needs to find areas with high potential. They use `search_properties` with filters (e.g., under $400k, 3 beds) and then feed the results into `get_property_comps`. This combination validates if the asking price is fair against recent neighborhood sales.

## Benefits

- Stop guessing value. Use `get_property_comps` to find comparable sales nearby, immediately giving you a data-backed estimate of what the house is really worth.
- Get immediate market context with tools like `get_top_neighborhoods`. Instead of manually researching zip codes, your agent ranks and summarizes the best local areas for investment.
- Save time on valuation. By calling `get_full_property_profile`, you pull tax history, transaction records, and AVM estimates into one structured output, bypassing multiple website visits.
- Validate rental income instantly. Use `get_rental_rates` or the dedicated `rento_calculator_lookup` to check current long-term and short-term market rates without leaving your workflow.
- Track down property facts. Need to know who owns it? Call `get_ownership_info`. This gives you critical due diligence data that is impossible to find in a simple listing description.

## How It Works

The bottom line is you talk to your AI client, and it handles the complex sequence of API calls needed for full real estate market analysis.

1. Subscribe to the server and enter your Mashvisor API Key.
2. Direct your AI agent (Claude, Cursor, etc.) to analyze a specific area or property type.
3. The agent calls the required tools (e.g., `list_cities` then `get_top_neighborhoods`), compiling all data points into a structured report.

## Frequently Asked Questions

**How do I find comparable properties using `get_property_comps`?**
You provide the target property's location or ID, and the tool returns a list of nearby sold properties. This helps you validate if the asking price falls within a realistic range based on recent sales.

**Can I check investment potential for an entire city using `get_city_investment_performance`?**
Yes, this tool summarizes key metrics and investment performance data for a whole city. It gives you the big-picture view before you dive into specific neighborhoods.

**`search_properties` vs. `get_marketplace_listings`, which one should I use?**
Use `search_properties` when you have strict filters (e.g., 3 beds, under $500k). Use `get_marketplace_listings` if you just want a general pull of all currently available listings in an area.

**What is the difference between `get_rental_rates` and `get_airbnb_listings`?**
`get_rental_rates` focuses on long-term rental averages for a general market. `get_airbnb_listings` provides specific, short-term performance metrics relevant to vacation rentals.

**What's the difference between using `get_property_details` and calling `get_full_property_profile`?**
Use `get_property_details` for quick attributes like bed/bath count or square footage. The full profile gives you deep data: tax history, transaction records, and the Mashvisor AVM score.

**How can I check if a city name is valid before running complex searches using `validate_city`?**
It validates the city and state combination first. Running this tool ensures your input data is clean, saving you API calls and preventing errors on later queries.

**When should I use `get_ownership_info`? Does it give me personal owner names?**
It provides legal ownership structure and contact indicators for a property. It focuses on the official records, not necessarily current occupants or private details.

**If I'm just brainstorming potential areas, how do I start? Should I use `get_top_neighborhoods`?**
This tool lists top neighborhoods based on investment performance. You get a ranked list of high-potential areas so you know exactly where to focus your property searches first.

**Can I find comparable properties for a specific address to estimate its value?**
Yes! Use the `get_property_comps` tool by providing the property address or ID. The agent will return a list of nearby properties with similar characteristics to help you perform a comparative market analysis.

**How do I check the investment performance of a specific city?**
You can use the `get_city_investment_performance` tool. Simply provide the state and city name, and the agent will retrieve key metrics like cash on return, cap rate, and rental income for that market.

**Is it possible to get ownership information and contact details for a property?**
Yes, the `get_ownership_info` tool retrieves owner contact information and residency indicators for a specific property ID or address, allowing you to identify potential leads or current owners.