Mashvisor MCP Server

Saved searches, property analyses and exports from your account.

Hosted MCP Server

npx add-mcp 'https://cotlet.dev/mcp/v1/mashvisor'

Installs into Claude Code, Codex, Cursor and more

Documentation

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

Mashvisor API and MCP server: Let your AI agent work your Mashvisor deal list.

Mashvisor has an app in the ChatGPT directory, built on MCP, since 6 May 2026, and a paid Data API. Both read market and property data: search, analysis, comps. Neither reads your filter presets, Saved Homes or Property Alerts, or makes the Excel and PDF files your plan includes (checked 27 Oct 2026). Cotlet runs 14 Mashvisor tools hosted, over MCP for agents and REST for scripts.

Saved searches, property analyses and exports from your account. Use it in ChatGPT, Claude or any AI agent over MCP, or in n8n, Make and scripts over REST.

MCP setup REST API guide

What can you automate in Mashvisor?

  • Run your filter presets each week
  • Rank every Saved Home by return
  • Analyze off-market leads from email
  • Set Property Alerts for a market
  • Export neighborhood data to Excel
  • Find markets by Mashmeter and occupancy

Does Mashvisor have an MCP server or an API?

  • Mashvisor's MCP server page lists 3 tools: search_location, get_property_details and get_investment_analysis. Its setup text points at an ngrok tunnel, so no address for Claude or Cursor is published.
  • The Data API is a separate product: 30 one-time sample calls free, then $129 a month for 500 calls and $0.30 for each extra call.
  • The AI Assistant in the dashboard answers market questions, free during launch, but only inside Mashvisor. Your own agent cannot call it.
What you needChatGPT appData APICotlet
Search for-sale homes by returnYesYesYes
Property analysis and compsYesYesYes
Run your saved filter presetsNoNoYes
Read and change Saved HomesNoNoYes
Property Alerts, Excel and PDFNoNoYes, alerts after your OK
Works in Claude, Cursor, n8nChatGPT onlyYour own codeYes
What you pay MashvisorInvestor plan plus ChatGPT PlusFrom $129 a monthYour investor plan

Checked 27 Oct 2026. Sources: Mashvisor launches in the ChatGPT App Directory (PR Newswire, 6 May 2026), Mashvisor MCP server page, Mashvisor API plans, Mashvisor AI Assistant, Mashvisor pricing

How does Cotlet connect to Mashvisor?

  1. Sign in to Mashvisor. Use your own account in its Cotlet Cloud Browser.
  2. Choose MCP or REST. Connect your agent or create a Cotlet API key.
  3. Run your workflow. Ask your agent or send an HTTP request.

We never keep your Mashvisor password, and no Property Alert is created before you approve it.

Connect Mashvisor to your agent or workflow

Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.

  1. Sign in to Mashvisor in a Cloud Browser. Create a Cotlet account, open Mashvisor in its Cloud Browser, sign in with your own investor login and press Enable for agents.
  2. Add the Cotlet address. Put https://cotlet.dev/mcp/v1 into your agent's MCP server or connector settings.
  3. Allow the connection. Chat apps open a Cotlet sign-in page. Code editors, n8n and scripts use an API key from the console instead.

https://cotlet.dev/mcp/v1 serves every app you enable in Cotlet, Mashvisor included. Enable Mashvisor after connecting, then refresh the connector so its tools show up.

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Cursor:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: mashvisor_read

Make, Zapier:

Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: mashvisor_write

How to use the Mashvisor REST API

Create your Cotlet API key

Create a Cotlet API key with access to Mashvisor and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.

Connect Mashvisor in Cotlet and enable it for agents. Account access: Your own Mashvisor investor account.

Make your first Mashvisor API request

REST:

curl https://cotlet.dev/api/v1/mashvisor/saved-homes \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read saved homes and apply the operation limits

A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.

Illustrative response excerpt:

{
  "status": "success",
  "app": "mashvisor",
  "tool": "list_saved_homes",
  "result": {
    "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
      }
    ]
  }
}

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.

limit: 1 to 100. Default: 50.

Keep the same selection when continuing a list. Compare changed record values as well as identifiers when refreshing your destination.

Mashvisor workflows for agents and automations

ToolConnect throughExample workflow
n8nHTTP RequestProperty Analytics page: price, rental income, cash flow, cap rate and cash on cash return per strategy, Mashmeter and expenses. Use get_property_analysis in your configured property report.
MakeHTTP > Make a requestComparable listings near a property, with occupancy, nightly rate, rent or sale price. Use get_property_comps in your configured property report.
Python or Node.jsREST APIYour Property Alerts with location, filters and email frequency. Use list_property_alerts in your configured property report.

Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.

Cotlet reads Mashvisor; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.

Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.

The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.

Mashvisor API endpoints and MCP tools

Search and analysis

Figures are Mashvisor's estimates on its nationwide default expenses. An off-market lookup also lands in Saved Homes, as it does in the app.

  • Find properties (find_properties, read): Property Finder: for-sale properties ranked by cash on cash return for your budget.
  • Search markets (search_markets, read): Market Finder: neighborhoods and cities ranked by rental performance, with your filters.
  • Get property analysis (get_property_analysis, read): Property Analytics page: price, rental income, cash flow, cap rate and cash on cash return per strategy, Mashmeter and expenses.
  • Get property comps (get_property_comps, read): Comparable listings near a property, with occupancy, nightly rate, rent or sale price.
  • Analyze unlisted property (analyze_unlisted_property, write): Look up an off-market address, add it to Saved Homes and return its rental analysis.

Filter presets and exports

Presets are made and deleted in Map Property Finder. Each Excel file or PDF uses one of your plan's downloads; Lite has no exports and PDFs come with Professional.

  • List filter presets (list_filter_presets, read): Your saved Map Property Finder filter presets, with name and filters.
  • Run filter preset (run_filter_preset, read): Apply a saved preset to a city or neighborhood and return the matching listings with their metrics.
  • Export neighborhood data (export_neighborhood_data, read): Excel export of a neighborhood from Map Property Finder. Uses one of your plan's monthly exports.
  • Download property report (download_property_report, read): PDF analytics report of a property, optionally with your company name and logo. Uses one download.

Saved Homes

Saving and removing a home reaches nobody, so both run at once.

  • List Saved Homes (list_saved_homes, read): Properties in your Saved Homes, with type, sale price and your rating.
  • Save home (save_home, write): Add a property to your Saved Homes.
  • Remove saved home (remove_saved_home, write): Remove a property from your Saved Homes.

Property Alerts

Mashvisor emails new matches daily, weekly or monthly, and only when there are any. You delete an alert in Find & Invest > Property Alerts.

  • List Property Alerts (list_property_alerts, read): Your Property Alerts with location, filters and email frequency.
  • Create Property Alert (create_property_alert, write, asks first): New Property Alert: Mashvisor emails you new listings that match, only when there are any.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/mashvisor-api-mcp-server#tools

Who can see my Mashvisor session, and how do I revoke it?

  • What we store. Your signed-in Mashvisor profile, AES-256-GCM encrypted, in Finland. Never the password.
  • What your agent gets. 14 Mashvisor tools. No cookie and no login.
  • What the session sees. What your plan unlocks: Lite has no exports, Professional adds PDFs.
  • What no tool touches. Billing, your plan, the CRM, outreach campaigns and account settings.
  • If Mashvisor signs you out. We email you a sign-in link. You sign in yourself, we never do.
  • How to cut access. Disable for agents, reset the browser or delete the key. The next call fails.

Mashvisor's own terms let it share your search history, favorites and saved searches with real estate professionals (Terms of Use, section 7). Cotlet passes your session to nobody. The Cotlet site has A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results); there is no SOC 2 report or third-party pentest yet.

Is it against Mashvisor's terms? Account safety

Webscraping, downloading or webcrawling of any property or other data for inclusion in another real estate search site, content aggregator, or any other purpose is strictly forbidden without prior written consent from Mashvisor.

Mashvisor Terms of Use, section 2.E (updated 29 Apr 2019, read 27 Oct 2026)

The clause is headed "Webscraping of Listing & Property Data Is Not Allowed" and its examples are about copying listings into another site. "Any other purpose" still reaches an agent reading Mashvisor for you, and Mashvisor "may terminate this Agreement or your account at any time, with or without notice". The terms also say not to "permit others to use your account". We found no public case of a Mashvisor account closed over automation (checked 27 Oct 2026). You read the terms and decide.

How we keep your account looking like you:

  • Your own Mashvisor login, typed in by you
  • One Cloud Browser with a steady IP and cookies, like your laptop
  • Tools read the homes, presets and markets you name, not the whole listing database
  • Excel and PDF files only through Mashvisor's own buttons, within your plan's downloads
  • If Mashvisor objects, we pause the Mashvisor tools for everyone within 24 h

Ranking a long Saved Homes list opens one Property Analytics page per home. Run it weekly rather than hourly, so your account reads like one investor doing homework.

What happens when Mashvisor changes?

  • 12 h between tests of Mashvisor search, analysis and Saved Homes reads
  • 24 h between tests of the Property Alert write, which sends you email
  • $0 for a call to a Mashvisor tool paused for a fix

Mashvisor rebuilt its Property Analytics page (help article of 1 Jul 2026) and added an AI Assistant to the dashboard this year. When a tab, a field or the Export button moves, we repair the tool and keep its name. status.cotlet.dev checks the site, console and API every 3 minutes.

Approvals, undo and mistakes

  1. Checks the lead. Price, type, beds, baths and square feet, or it asks you.
  2. Runs the analysis. Airbnb and long-term returns; the home lands in Saved Homes.
  3. Tests it on comps. Nearby nightly rates and occupancy against the estimate.
  4. Keeps or removes it. Under your cap rate line, the home leaves Saved Homes.
ActionUndo
Analyze an unlisted propertyremove_saved_home takes it out of Saved Homes
Save a homeremove_saved_home
Remove a saved homesave_home adds it back
Create a Property AlertNo tool; delete it in Find & Invest > Property Alerts
Excel export or PDF reportThe download is used and does not come back

create_property_alert is the one write that asks first, because Mashvisor starts emailing you from it. analyze_unlisted_property, save_home and remove_saved_home change only your own Saved Homes and run at once. Reads run at once too, though export_neighborhood_data and download_property_report spend your plan's downloads, so the agent makes files only when you ask. For a scheduled run you can switch the wait off per tool.

Mashvisor deletes a filter preset from its dropdown without asking. No Cotlet tool deletes presets, so a scheduled scan cannot lose your buy box.

MCP call:

{
  "name": "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"
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/mashvisor/property-alerts \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Cleveland SFH under 200k","location":"Cleveland, OH","property_type":"single_family","price_max":200000,"financing":"cash","min_cap_rate":8,"frequency":"weekly"}'

Response:

{
  "alert_id": "pa_58213",
  "name": "Cleveland SFH under 200k",
  "location": "Cleveland, OH",
  "frequency": "weekly",
  "email_to": "yourname@example.com",
  "status": "active"
}

A spreadsheet macro or a cron job can call the same tools over REST at /api/v1/mashvisor, with one key and one price: for example, every wholesaler lead in a sheet run through analyze_unlisted_property overnight. A call your plan does not allow returns an error and costs nothing. Every tool row above lists its REST path.

How much does the Mashvisor MCP server cost?

About $16 a month for one investor watching two markets, 2,800 credits. You keep your Mashvisor plan; Standard is $74.99 a month billed yearly.

JobCallsCredits
Preset scan of 3 neighborhoods, weekly7 × 4280
Rank 12 Saved Homes with comps, weekly15 × 4600
Off-market leads from wholesaler emails3 × 10300
Neighborhood Excel export, weekly2 × 480
Market Finder check, twice a month1 × 220
One new Property Alert2 × 120
Cloud Browser, 30 days1,500
Total2,800
  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • No Data API plan needed

The month is our example: one investor on Standard, three neighborhoods a week, 12 Saved Homes, 10 off-market leads and 4 Excel exports, inside Standard's 10 property search exports a month. Mashvisor publishes no typical usage. For scale, its Data API starts at $129 for 500 calls. Dollars at the $29 pack rate.

Mashvisor MCP server on GitHub, Zapier or hosted: which to use

OptionWhat it doesWhere it stops
mcphub-com/mashvisorPython MCP server with 46 tools on the RapidAPI Mashvisor API, MIT. 0 stars, last push 2 Sep 2025.Needs a paid RapidAPI key; never sees your presets, Saved Homes or alerts.
aigeon-ai/mashvisorThe same server, no license. 0 stars, last push 29 Jul 2025.Same limits, and no license to use it.
MashGPTMashvisor's chat analyst for US rental questions, free to start, launched 12 May 2026.A separate site; no account actions named.
Zapier, n8nNo Mashvisor app in either (checked 27 Oct 2026).Nothing to connect.

If you want market answers inside ChatGPT, Mashvisor's own app does that on your subscription. If you build a product on rental data, buy the Data API. If your agent should run your presets, keep Saved Homes tidy, set alerts and pull exports, Cotlet does that hosted.

Also listed on: Odel, mcpbeat

Who runs Cotlet

Take Group sp. z o.o. runs Cotlet: a software company registered in Poland, EU (VAT PL6342984273), in business since 2019. The founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Mashvisor tools go to contact@cotlet.dev.

Mashvisor API and MCP: questions

How do I get access?

Sign up free at https://cotlet.dev, open Mashvisor under Integrations in the console and sign in to Mashvisor in its Cloud Browser. The trial starts when you sign up and needs no card.

How do I connect Mashvisor to ChatGPT or Claude?

Sign up at cotlet.dev, log in to Mashvisor once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Mashvisor account through Cotlet, in their phone apps too.

What can ChatGPT do in Mashvisor?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Mashvisor: weekly deal scan with a saved filter preset; compare your Saved Homes; analyze an off-market property. You ask in plain words, and anything that reaches other people waits for your OK first.

Do I need the Mashvisor Data API plan?

No. Cotlet works in your own Mashvisor investor account and does not use the Data API, which Mashvisor sells separately from $129 a month with an API key.

Why not just use the Mashvisor app in ChatGPT?

Use it if market questions are all you need. It answers from Mashvisor's data with 3 tools, but it cannot run your presets, read Saved Homes, set alerts or export, and it works in ChatGPT only. Cotlet works in your account and from any MCP client.

Does it work outside the US?

Mashvisor has full data, long-term and short-term, for the US only. For 13 other countries, among them Canada, the United Kingdom and Australia, it lists short-term rental data, and the tools return what Mashvisor shows for the address.

Is the MCP server different from the REST API?

Only in how you call it. Both have the same 14 tools, inputs and answers, with one API key and one price. Agents use MCP; scripts and spreadsheets use REST.

Is Cotlet affiliated with Mashvisor?

No. Cotlet is independent and not affiliated with Mashvisor Inc.

Can I use the Mashvisor API without an AI agent?

Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.


Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.