# Run a weekly Mashvisor deal scan with your saved filter presets

> Run your saved Mashvisor filter presets across several neighborhoods each week, drop listings already in Saved Homes and rank new ones by return.

Source: https://cotlet.dev/integrations/mashvisor-api-mcp-server/run-saved-filter-preset

Your Mashvisor preset holds the buy box: price cap, bedrooms, property type, a minimum cap rate. Every Monday you still open Map Property Finder, type each neighborhood, pick the preset from the dropdown and scroll the list to spot what is new since last week.

Cotlet does it in your own Mashvisor account with list\_filter\_presets, run\_filter\_preset, list\_saved\_homes, save\_home and export\_neighborhood\_data, called by your AI agent, an n8n workflow or a script.

[Request access](https://cotlet.dev/app/signup?app=mashvisor) [All Mashvisor tools](https://cotlet.dev/integrations/mashvisor-api-mcp-server)

Hosted · nothing to install or maintain

Official options

## Can Mashvisor do this on its own?

Mashvisor itself saves filter presets in Map Property Finder and sends Property Alerts by email daily, weekly or monthly, but only when at least one property matches (checked 12 Oct 2026). Alerts are set up separately under Find & Invest > Property Alerts, in a form with its own fields (location, property type, beds and baths, price range, financing, minimum cash on cash return and cap rate), so a preset saved in Map Property Finder does not turn into an alert. Neither feature compares results with your Saved Homes. The Data API, sold separately from $129 a month, has search endpoints but cannot read your presets.

By hand

## How you do it in Mashvisor today

1. Go to Map Property Finder and type a city or neighborhood in the search box at the top of the page.
2. Click the arrow next to All Properties in the upper-right corner and pick your saved preset; switch the left panel between the Investment, Airbnb Comps and Rental Comps tabs as needed.
3. Click Table to sort the listings by price, cap rate, beds or baths, size or date listed, then open each promising property to read its Property Analytics page.
4. Click Export and choose Export Filtered View when you want the list in Excel; Mashvisor only exports a neighborhood search, so each neighborhood is its own file.
5. Repeat for the next neighborhood. The preset returns every listing that matches, so homes you reviewed last Monday come back alongside the new ones and a fresh listing is easy to scroll past.

With an agent

## How to run a weekly Mashvisor deal scan with your saved filter presets

Prompt

```
Every Monday, run my "Tampa STR under 400k" preset in Ybor City and Seminole Heights, skip anything already in my Saved Homes, and list the 5 best new listings by Airbnb cash on cash return.
```

1. 01  
### Resolve the preset by name  
The agent looks up the preset you named in list\_filter\_presets. If two presets have similar names ("Tampa STR" and "Tampa STR old"), it asks which one before running anything, because a wrong buy box makes the whole scan useless.
2. 02  
### Run it once per neighborhood  
run\_filter\_preset goes through each neighborhood you listed on the Investment tab. A neighborhood with zero matches is reported as zero, not silently dropped, so you can tell a quiet market from a typo in the location.
3. 03  
### Remove what you have already seen  
Before ranking, the agent reads list\_saved\_homes and drops any listing whose property\_id is already there, so a home you saved in March does not come back as a find every Monday. Listings you rejected but never saved can return; tell the agent to save or skip them and the next scan stays short.
4. 04  
### Rank by the strategy you buy for  
Listings are sorted by Airbnb or traditional cash on cash return, whichever the prompt names. Mashvisor's figures assume default expenses, so the agent flags results where the return depends on a high occupancy rate rather than presenting them as safe.
5. 05  
### Save or export only on request  
save\_home adds the picks you approve to Saved Homes. An Excel file via export\_neighborhood\_data is made only when you ask for it, because each one counts against your plan's monthly exports.

### What you get back

Example data

```
Preset "Tampa STR under 400k", run 12 Oct 2026, Investment tab.
Ybor City: 11 matches, 3 already in Saved Homes, 8 left to rank.
Seminole Heights: 0 matches; check the spelling or widen the preset.
1. 910 E 8th Ave: $389,000, Airbnb cash on cash 10.8%, cap rate 8.1%, listed 4 days ago.
2. 2204 N 15th St: $329,000, Airbnb cash on cash 10.2%, cap rate 7.9%.
Both saved to Saved Homes after your OK. No Excel export used this week.
```

### Other ways to ask

- Run all my presets in Cleveland once a month and send me only listings with a cap rate above 8%.
- Export the Airbnb Comps tab of Ybor City to Excel with my "Tampa STR under 400k" preset applied.
- Compare what my preset finds this week with my Property Alerts for Tampa and tell me which alert is too loose.
- Run the "Cleveland cash flow" preset on the Rental Comps tab and give me the median rent for 3-bedroom homes.

Before you automate it

## What Mashvisor allows, and what to know first

- Mashvisor saves a preset with Save Filters in Map Property Finder, and deleting one from the preset dropdown happens without a confirmation prompt.
- Mashvisor's neighborhood export does not work on a city-level search, and Export All Data ignores your filters while Export Filtered View keeps them.
- The Mashvisor Lite plan does not include Property Finder, multi-family search or Exporting Neighborhood Data.
- Mashvisor Property Alerts are refreshed with listings updated nightly and email you only when at least one property matches.

save\_home changes only your own Mashvisor data and reach no one else, so it runs without asking first.

Sources: [Mashvisor Help: How to Create Your Own Filter Preset](https://help.mashvisor.com/en/articles/10163103-how-to-create-your-own-filter-preset) · [Mashvisor Help: Two Ways to View Search Results on Map Property Finder](https://help.mashvisor.com/en/articles/10174402-two-ways-to-view-search-results-on-map-property-finder) · [Mashvisor Help: How to Export Neighborhood Data](https://help.mashvisor.com/en/articles/1526213-how-to-export-neighborhood-data) · [Mashvisor Help: Add and save property alerts](https://help.mashvisor.com/en/articles/7060788-add-and-save-property-alerts) · [Mashvisor Help: Why can't I access some features?](https://help.mashvisor.com/en/articles/2032876-why-can-t-i-access-some-features)

REST

## Call run\_filter\_preset from a script

curl

```
curl https://cotlet.dev/api/v1/mashvisor/run_filter_preset \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"preset_id":"fp_2041","location":"Ybor City, Tampa, FL","tab":"investment","limit":25}'
```

Example response

```
{
"preset": "Tampa STR under 400k",
"location": "Ybor City, Tampa, FL",
"tab": "investment",
"listings": [
{
"property_id": "p_88120",
"address": "1823 Schyler Ln, Tampa, FL",
"price": 365000,
"cash_on_cash": 13.1,
"cap_rate": 9.4
},
{
"property_id": "p_88151",
"address": "910 E 8th Ave, Tampa, FL",
"price": 389000,
"cash_on_cash": 10.8,
"cap_rate": 8.1
},
{
"property_id": "p_88163",
"address": "2204 N 15th St, Tampa, FL",
"price": 329000,
"cash_on_cash": 10.2,
"cap_rate": 7.9
}
]
}
```

MCP: add https://cotlet.dev/mcp/v1 with the same key; the tool is mashvisor\_run\_filter\_preset. Example data.

[Schedule it in n8n, Make, Zapier or cron](https://cotlet.dev/integrations/mashvisor-api-mcp-server#automations)

Tools

## Mashvisor tools this automation uses

__Cotlet Mashvisor tools used to run a weekly Mashvisor deal scan with your saved filter presets__
| Tool | Parameters |
| -------------------------- | -------------------------------- |
| list\_filter\_presets | none |
| run\_filter\_preset | preset\_id, location, tab, limit |
| list\_saved\_homes | limit |
| save\_home | property\_id |
| export\_neighborhood\_data | neighborhood, tab, preset\_id |

[All 14 Mashvisor tools with descriptions](https://cotlet.dev/integrations/mashvisor-api-mcp-server#tools)

## More Mashvisor automations

- [Compare all your Mashvisor Saved Homes side by side](https://cotlet.dev/integrations/mashvisor-api-mcp-server/compare-saved-homes)
- [Analyze an off-market property in Mashvisor from a wholesaler email](https://cotlet.dev/integrations/mashvisor-api-mcp-server/analyze-off-market-property)
- [Mashvisor API and MCP server: every tool](https://cotlet.dev/integrations/mashvisor-api-mcp-server)
- [All use cases](https://cotlet.dev/use-cases)

## Give your agent access to Mashvisor.

Free 7-day trial with 5,000 credits, no card needed. Cotlet is independent and not affiliated with Mashvisor.

[Request access](https://cotlet.dev/app/signup?app=mashvisor)