Mashvisor MCP tools

MCP tool mashvisor_find_properties

Searches for-sale properties in one or more cities, as in Property Finder, ranked by cash on cash return for the rental strategy you pick. Radius works only with one city. Each item has the property_id that the analysis, comps and Saved Homes tools take.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_find_properties",
    "arguments": {
      "cities": [
        "Tampa, FL"
      ]
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "properties": [
      {
        "property_id": "p_88120",
        "address": "1823 Schyler Ln, Tampa, FL",
        "price": 365000,
        "bedrooms": 3,
        "bathrooms": 2,
        "cash_on_cash": 13.1,
        "cap_rate": 9.4
      },
      {
        "property_id": "p_88144",
        "address": "57 Palm Ct, Tampa, FL",
        "price": 342000,
        "bedrooms": 3,
        "bathrooms": 2,
        "cash_on_cash": 11.7,
        "cap_rate": 8.5
      }
    ]
  },
  "isError": false
}

MCP tool mashvisor_list_filter_presets

Returns the filter presets you saved with Save Filters in Map Property Finder, each with its name and filters. Pass preset_id to run_filter_preset or export_neighborhood_data. Presets are created, renamed and deleted in Mashvisor, not through Cotlet.

Parameters

No parameters.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_list_filter_presets",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "presets": [
      {
        "preset_id": "fp_2041",
        "name": "Tampa STR under 400k",
        "filters": {
          "price_max": 400000,
          "bedrooms_min": 3,
          "property_type": "single_family"
        }
      },
      {
        "preset_id": "fp_2057",
        "name": "Cleveland cash flow",
        "filters": {
          "price_max": 200000,
          "bedrooms_min": 2
        }
      }
    ]
  },
  "isError": false
}

MCP tool mashvisor_run_filter_preset

Applies one saved preset to a city or neighborhood and returns the matching listings with their metrics, like selecting the preset in Map Property Finder. The tab picks the same three views as the app: investment, airbnb_comps or rental_comps. Results come back in the order the app shows them.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_run_filter_preset",
    "arguments": {
      "preset_id": "fp_2041",
      "location": "Ybor City, Tampa, FL",
      "tab": "investment",
      "limit": 25
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "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
      }
    ]
  },
  "isError": false
}

MCP tool mashvisor_get_property_analysis

Returns the numbers of the Property Analytics page for one property: price, rental income, expenses, cash flow, cap rate and cash on cash return, for the Airbnb and the traditional rental strategy. Set strategy to get one of them. Figures are estimates from Mashvisor, as in the app.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_get_property_analysis",
    "arguments": {
      "property_id": "p_88120",
      "strategy": "both"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "property_id": "p_88120",
    "address": "1823 Schyler Ln, Tampa, FL",
    "price": 365000,
    "cash_invested": 91250,
    "airbnb": {
      "monthly_revenue": 4000,
      "monthly_operating_expenses": 1150,
      "monthly_mortgage": 1850,
      "monthly_cash_flow": 1000,
      "cap_rate": 9.4,
      "cash_on_cash": 13.1
    },
    "traditional": {
      "monthly_revenue": 2600,
      "monthly_operating_expenses": 650,
      "monthly_mortgage": 1850,
      "monthly_cash_flow": 100,
      "cap_rate": 6.4,
      "cash_on_cash": 1.3
    }
  },
  "isError": false
}

MCP tool mashvisor_get_property_comps

Returns comparable listings near one property. short_term gives Airbnb comps with occupancy and nightly rate, long_term gives rentals with monthly rent, and sales gives sold or listed prices. Nearest comps come first.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_get_property_comps",
    "arguments": {
      "property_id": "property_8c41d2",
      "type": "short_term"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "property_id": "p_90417",
    "type": "short_term",
    "comps": [
      {
        "address": "420 Oak Street, Austin, TX",
        "bedrooms": 3,
        "nightly_rate": 245,
        "occupancy": 68,
        "distance_miles": 0.2
      },
      {
        "address": "17 Elm Ave, Austin, TX",
        "bedrooms": 3,
        "nightly_rate": 229,
        "occupancy": 63,
        "distance_miles": 0.4
      }
    ]
  },
  "isError": false
}

MCP tool mashvisor_search_markets

Returns neighborhoods and cities from Market Finder, ranked by rental performance, with your filters applied. Filter by state, Mashmeter grade, minimum monthly revenue, minimum occupancy and property types. Without a state it searches nationwide.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_search_markets",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "markets": [
      {
        "market": "Gatlinburg, TN",
        "mashmeter": "A",
        "occupancy": 72,
        "monthly_revenue": 5400
      },
      {
        "market": "Destin, FL",
        "mashmeter": "A",
        "occupancy": 69,
        "monthly_revenue": 5100
      },
      {
        "market": "Pigeon Forge, TN",
        "mashmeter": "A",
        "occupancy": 67,
        "monthly_revenue": 4700
      }
    ]
  },
  "isError": false
}

MCP tool mashvisor_list_saved_homes

Returns the properties in your Saved Homes with type, sale price and your rating. Properties added by analyze_unlisted_property or save_home are included. Use property_id with get_property_analysis, get_property_comps or remove_saved_home.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_list_saved_homes",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "homes": [
      {
        "property_id": "p_88120",
        "address": "1823 Schyler Ln, Tampa, FL",
        "type": "single_family",
        "sale_price": 365000,
        "rating": 4
      },
      {
        "property_id": "p_90417",
        "address": "412 Oak Street, Austin, TX",
        "type": "single_family",
        "sale_price": 385000,
        "rating": null
      }
    ]
  },
  "isError": false
}

MCP tool mashvisor_list_property_alerts

Returns your Property Alerts with their location, filters and email frequency. Use it before create_property_alert so your agent does not add a duplicate.

Parameters

No parameters.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_list_property_alerts",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "alerts": [
      {
        "alert_id": "pa_58102",
        "name": "Tampa condos",
        "location": "Tampa, FL",
        "property_type": "condo",
        "price_max": 300000,
        "frequency": "weekly"
      }
    ]
  },
  "isError": false
}

MCP tool mashvisor_export_neighborhood_data

Creates the Excel export that the Export button gives in Map Property Finder, for one neighborhood and one tab. Without preset_id it exports all data; with a preset it exports only the matching listings. City-level export is not supported. Each call uses one of your plan's monthly exports, so it reads from Mashvisor but is not free of limits.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_export_neighborhood_data",
    "arguments": {
      "neighborhood": "neighborhood",
      "tab": "investment"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "neighborhood": "Ybor City, Tampa, FL",
    "tab": "airbnb_comps",
    "scope": "filtered",
    "file_name": "ybor-city-airbnb-comps.xlsx",
    "download_url": "https://files.cotlet.example/exports/ybor-city-airbnb-comps.xlsx",
    "rows": 38
  },
  "isError": false
}

MCP tool mashvisor_download_property_report

Creates the PDF analytics report from the download icon on a property page. With branded set to true it adds the company name and logo saved in your account. Mashvisor limits downloads by plan, and each call uses one.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_download_property_report",
    "arguments": {
      "property_id": "property_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "property_id": "p_88120",
    "branded": false,
    "file_name": "schyler-ln-tampa-report.pdf",
    "download_url": "https://files.cotlet.example/reports/schyler-ln-tampa-report.pdf"
  },
  "isError": false
}

MCP tool mashvisor_analyze_unlisted_property

Runs the "look up not listed property" flow for an address and returns the rental analysis. It adds the property to your Saved Homes. This reaches no one and is undone with remove_saved_home, so it runs without asking first.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_analyze_unlisted_property",
    "arguments": {
      "address": "412 Oak Street, Austin, TX",
      "price": 385000,
      "property_type": "single_family",
      "bedrooms": 3,
      "bathrooms": 2,
      "sqft": 1650
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "property_id": "p_90417",
    "address": "412 Oak Street, Austin, TX",
    "saved_to_saved_homes": true,
    "price": 385000,
    "cash_invested": 96250,
    "airbnb": {
      "monthly_revenue": 4200,
      "monthly_operating_expenses": 1200,
      "monthly_mortgage": 1950,
      "monthly_cash_flow": 1050,
      "cap_rate": 9.4,
      "cash_on_cash": 13.1
    },
    "traditional": {
      "monthly_revenue": 2700,
      "monthly_operating_expenses": 650,
      "monthly_mortgage": 1950,
      "monthly_cash_flow": 100,
      "cap_rate": 6.4,
      "cash_on_cash": 1.2
    }
  },
  "isError": false
}

MCP tool mashvisor_save_home

Adds one property to your Saved Homes. This reaches no one and is undone with remove_saved_home, so it runs without asking first.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_save_home",
    "arguments": {
      "property_id": "property_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "property_id": "p_88144",
    "saved": true
  },
  "isError": false
}

MCP tool mashvisor_remove_saved_home

Removes one property from your Saved Homes. This reaches no one and the property can be added again with save_home, so it runs without asking first.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_remove_saved_home",
    "arguments": {
      "property_id": "property_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "property_id": "p_88144",
    "saved": false
  },
  "isError": false
}

MCP tool mashvisor_create_property_alert

Creates a Property Alert in your account. Mashvisor then emails you new matching listings at the frequency you set, and only when there are any. Price runs from 5,000 to 5,000,000 USD. There is no tool to delete an alert, so you remove one in Mashvisor. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mashvisor_create_property_alert",
    "arguments": {
      "name": "Cleveland SFH under 200k",
      "location": "Cleveland, OH",
      "property_type": "single_family",
      "price_max": 200000,
      "financing": "cash",
      "min_cap_rate": 8,
      "frequency": "weekly"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "alert_id": "pa_58213",
    "name": "Cleveland SFH under 200k",
    "location": "Cleveland, OH",
    "frequency": "weekly",
    "email_to": "yourname@example.com",
    "status": "active"
  },
  "isError": false
}