Guide
Breeze in your assistant: the MCP server for brokers

If you are a broker with Breeze access, you can connect your account to Claude or ChatGPT and manage your inventory by talking to your assistant. This page explains what it can do, what you need and how to connect it step by step.
-
Your assistantClaude or ChatGPT, with the option to add connectors.
asks for permission once
-
Your Breeze accountYou sign in and approve the permissions you choose.
issues limited access
-
Breeze MCP serverTranslates each assistant request into the Breeze API.
acts only with your permissions
-
Your inventoryYour units, your submissions and My zone. Nothing from other brokers.
- What the assistant uploads goes into review: nothing is published without the Breeze team.
- To cut access, remove the connector or ask the Breeze team to revoke it.
What MCP is
MCP (Model Context Protocol) is an open standard for connecting AI assistants to outside services. Breeze runs an MCP server: once you connect it, your assistant can look up and update your Breeze account when you ask it to.
What the assistant can do
The server offers nine tools. You don't need to name them: the assistant picks the one that fits what you ask.
- Search inventory: the same public search as the site, with no broker data.
- My units: your units, with their status and whether they are under review or were rejected.
- Update unit: changes the price, currency or status of one of your units. Before changing it, the assistant looks it up; if someone changed it in the meantime, it asks you to confirm again.
- Create inventory submission: adds a unit, which goes under review.
- Create development draft: from the brochure you attach, adds a development with its unit types as a draft.
- Import photos from Google Drive: downloads the photos in a shared folder to your unit, your submission or your development.
- Upload link: gives you a link to upload photos from your phone, without Drive.
- Status of my submissions: where each submission, draft and import stands, with the reason if something was rejected.
- My zone: the aggregated summary of your areas, if that feature is turned on for you.
A few examples of what you can say: "Show me my units on Breeze", "Mark the house on such-and-such street as sold", "How are my submissions doing?". Always state the currency of a price, pesos or dollars. If you work with more than one agency, the assistant will ask which one it is for.
What you need
- A Breeze account with a confirmed email, set up as a broker for your agency.
- API and assistant access turned on by the Breeze team. Ask your Breeze contact and say what you plan to use it for: viewing units, changing prices, adding inventory or developments, viewing your area.
- Claude (claude.ai, the app or Claude Code) or ChatGPT with the option to add connectors.
Without active access, you will see a "no access" screen when you connect.
The server address
The address is the same in every assistant: https://www.breezerealestate.mx/mcp
Claude's and ChatGPT's screens change often. If a button has a different name or sits somewhere else, look for the connectors section in the settings.
In Claude (claude.ai or the app)
- Open Settings → Connectors.
- Choose Add custom connector.
- Name: Breeze. URL: https://www.breezerealestate.mx/mcp. Save.
- Click Connect. Breeze opens in your browser: sign in and click Authorize.
- In a new conversation, turn on the Breeze connector from the tools or connectors menu.
On team or enterprise plans, your Claude account administrator may need to add the connector first.
In Claude Code
- In your terminal, add the server: claude mcp add --transport http breeze https://www.breezerealestate.mx/mcp
- Inside Claude Code, type /mcp, choose breeze and follow the option to authenticate. Breeze opens in your browser: sign in and click Authorize.
- Ask it, for example, "list my units on Breeze".
In ChatGPT
- Open Settings → Apps & Connectors.
- If you don't see a way to add your own, turn on Developer mode in the advanced settings of that same section.
- Choose Create or Add connector, paste the URL https://www.breezerealestate.mx/mcp and choose OAuth as the authentication.
- Breeze opens in your browser: sign in and click Authorize.
- In a conversation, pick the Breeze connector from the tools menu.
Authorization
Your assistant never receives your password. You sign in on Breeze's own page, which shows you the permissions you are granting and which service you are returning to. When you click Authorize, Breeze gives the assistant temporary access that renews itself only while you keep using it.
If the connection drops, for example because Breeze changed your permissions or you haven't used it for more than a month, the assistant will ask you to reconnect: repeat the Connect step.
Photos from Google Drive or your phone
Put your photos, in JPG, PNG or WebP, in a Drive folder and share it as "Anyone with the link", with viewer permission. If you'd rather not make it public, share it only with the email of Breeze's service account, which we give you when we turn on your access. Give the link to the assistant and tell it which unit, submission or development the photos are for.
iPhone HEIC photos are not accepted yet: export them as JPG. Videos, subfolders and Google documents are ignored.
Without Drive, ask for "a link to upload photos". The link is valid for 24 hours, doesn't ask you to sign in and is tied to the first browser or phone you upload from, so don't share it.
What happens next
- Inventory: the unit is created right away, under review. You see it in your units and in a private preview, but it is not public until the Breeze team approves it, with at least one approved photo.
- Developments: they stay as a draft. The team checks each field against the brochure before publishing and removes appreciation, return or occupancy figures.
- Photos: they stay pending and appear on the listing once the team approves them.
- Price and status of your published units: the change applies immediately and goes into the price history.
What the assistant sees and what it doesn't
The assistant acts with your account's permissions and nothing more. It sees your units and those of your agency that your account can see, your submissions, drafts and imports, and the aggregated data in "My zone".
It cannot:
- See or edit other brokers' units, leads or data.
- Give you personal or contact details of buyers or clients.
- Publish anything without Breeze's review, or activate a unit for the first time.
- Delete units, published photos or submissions.
- Make up market figures: when there is not enough data, it answers "No data".
What the tools return is read by your assistant and stays in your conversation under Claude's or ChatGPT's terms. Apart from what you submit, Breeze does not keep the content of your requests or of the answers in its technical logs.
Your unit limit, a paused account and the features you have turned on apply just as they do in the portal. If something is not allowed, the assistant tells you why.
How to revoke access
- Remove the Breeze connector in your assistant's settings.
- Or ask the Breeze team to revoke your access. Once revoked, every connection on your account stops working within a minute, in any assistant.