This page hasn't been translated for your language. Showing the English (United Kingdom) version.
Fondaro MCP
Connect ChatGPT, Claude, Claude Code, Cursor and other AI clients to your Fondaro account with browser sign-in or a scoped API key.
Fondaro MCP lets an AI client you already use (ChatGPT, Claude, Claude Code, Cursor and others) work with your leads, listings, brochures and documents in plain language. It acts as you, with exactly the access you have in Fondaro: a member sees their own leads, an admin the whole agency.
Open it from Settings › Integrations › Fondaro MCP, under For developers, as an admin or a team member. Claude and ChatGPT also have their own cards at the top of Settings › Integrations, with just their steps. The page has two modes: Connect sets up a client, Your connections lists and revokes what is connected. If you are a developer and want to call Fondaro from your own code rather than an AI client, make an API key instead: see API keys.
Find the endpoint
Every client uses the same address, with no trailing slash:
ChatGPT, Claude and Claude Code sign in through your browser. Every other client sends a Fondaro API key as Authorization: Bearer fdr_mcp_…. Fondaro supports MCP 2026-07-28 and negotiates earlier versions back to 2024-10-07 automatically.
Connect ChatGPT
- Open Fondaro's plugin page in ChatGPT and choose to add Fondaro to ChatGPT.
- Sign in to Fondaro, choose the organization, review the permissions and select Allow.
There is no token to copy. The connection shows under Your connections. On a ChatGPT workspace where plugins are turned off, an admin can add it as a custom app with https://api.fondaro.com/mcp/v1 as its MCP server URL.
Connect Claude on the web, desktop or phone
- Open Fondaro in Claude's directory and choose Connect. You can also find it in Claude under Settings, then Connectors, by searching for Fondaro.
- Sign in to Fondaro, choose the organization, review the permissions and select Allow.
There is no token to copy. Once connected, Fondaro works in Claude on the web, the desktop app and your phone. On a Claude Team or Enterprise plan, an owner may need to allow it for your organization first. If the directory is turned off, an owner can add it as a custom connector with https://api.fondaro.com/mcp/v1.
Connect Claude Code
-
Update Claude Code to a current version.
-
Run:
-
Start Claude Code, open
/mcp, choosefondaro, then Authenticate. -
Sign in to Fondaro, choose the organization and select Allow.
Don't add an Authorization header: Claude Code handles sign-in itself.
Connect another client with an API key
1. Create a key
On Connect, pick your client (Codex CLI, Cursor, Visual Studio Code or Another client) and create a key. Give it a clear name, keep only the scopes it needs, and optionally an expiry. The key starts with fdr_mcp_ and is shown once: save it in a password manager. Use one key per client and computer.
2. Load the key in your terminal
Run the command for your computer and paste the key when it waits. The input is hidden and the key never lands in your history.
The first is for macOS (zsh), the second for Linux (bash), the third for Windows PowerShell. The key lasts until you close that terminal; start your client from it. Never paste the key into .zshrc, .bashrc, a project .env file or a committed config.
3. Configure the client
Codex CLI:
Cursor, in your global (not project) mcp.json, then launch with cursor . from the same terminal:
Visual Studio Code, in MCP: Open User Configuration. It asks for the key once and keeps it in its own secret storage:
Another client: set the endpoint and an Authorization header of Bearer plus your key, but only in a field the client marks as private or secret.
4. Check the connection
Make one read-only request from the client, then select Check connection in Fondaro. It says Connection received when that key has been used.
Choose scopes
| Scope | Allows |
|---|---|
crm:read | Read leads, tasks, notes, deals, calls, emails, messages, your Inbox, calendar and teams |
crm:write | Create and change CRM records (needs a plan) |
properties:read | Search property sources, read listings, open houses and viewings |
brochures:read | List and open brochures |
brochures:write | Create and manage brochures; also needs properties:read |
documents:read | List and open documents (needs a plan) |
documents:write | Write and change documents, attach them, manage share links (needs a plan) |
A key keeps the scopes it was created with. To add one, create a replacement key, connect with it, then revoke the old one.
Revoke a connection
On Your connections, open a row's ⋯ menu and choose Revoke (a key) or Disconnect (an app), then confirm. It stops working at once and can't be undone. Each credential is separate, so revoking one never touches another. Admins also see Your team, with every teammate's keys. When someone leaves your agency, their keys and apps stop working within minutes.
A key you created but never used shows Finish setup. Fondaro does not keep the full key, so if you lost it, create a replacement.
What the assistant can do
- Leads: search, read a lead and its timeline, create leads, update contact details, status and tags.
- Tasks, notes and deals: list, create and update them; move or close a deal.
- Inbox and calendar: read who is waiting on you and your calendar.
- Calls, emails and messages: read a lead's calls, transcripts, reviews, emails and chats.
- Semantic search: find people whose history matches a description or fits one listing.
- Properties: search the Fondaro network, your connected sources and the property sites of your market, and open a listing.
- Brochures: create a brochure of 1 to 25 listings from a search, update, renew or revoke it, and get its share link.
- Documents: read, write and edit documents, and publish or take down a share link.
- Lead routing (admins): read your routes, try a lead to see who would get it, add, change, reorder or delete a route, switch Smart routing, route the leads waiting in Unassigned, and mark someone away. See Lead routing.
Reassigning a lead's owners, moving many leads at once and everything in lead routing except marking yourself away are for admins only. Anyone with a brochure's link can open it until it expires or is revoked, and what you ask also sits in your AI client's history.
Troubleshooting
| Problem | Fix |
|---|---|
| ChatGPT doesn't open Fondaro sign-in | Add Fondaro from its plugin page in ChatGPT again. If you added it as a custom app, check it uses exactly https://api.fondaro.com/mcp/v1, then refresh its actions. |
| Claude doesn't open Fondaro sign-in | Choose Connect on Fondaro in Claude again. If you added it as a custom connector, check it uses exactly https://api.fondaro.com/mcp/v1. |
| Claude Code shows Needs authentication | Open /mcp, choose fondaro and authenticate again. |
| An API-key client can't connect | Check the endpoint, that the variable is loaded in the terminal that started the client, and that the key is sent as a bearer token. |
| A protocol or handshake error | Update the client and reconnect. |
| A key stopped working | It expired or was revoked. Create a new one. |
| A tool is missing | The key lacks the scope, the tool is for admins, or your agency has no plan. |
| A search of outside property sites says the daily limit is reached | Those searches share a daily limit per agency, reset at midnight UTC. Your own sources keep working. |
The full tool list is in the MCP server reference. Fondaro's chat is the assistant built into the dashboard; Fondaro MCP is the way in for one you use elsewhere. Questions: support@fondaro.com.