AssistantFirst I'll find Sarah in your pipeline.
Tool call · 01
leads_
{ "q": "Sarah" }ResultSample data
Found 1 lead(s).
| id | name | stage | budgetMax |
|---|---|---|---|
| 6650…a41f | Sarah M. | qualified | 2,500,000 |
WIYO MCPModel Context Protocol
Run your brokerage in a conversation.
WIYO MCP connects Claude, ChatGPT and other AI assistants to your leads, off-plan inventory, listings and WhatsApp: 39 tools, each one bound by the agent's own permissions.
- Server
- Remote MCP over Streamable HTTP
- Sign-in
- OAuth with the agent's own WIYO login
- Tools
- 39 across 6 domains
- Clients
- Claude, ChatGPT and other MCP clients
- Runs as
- The signed-in agent: their role, their company
What MCP is
The Model Context Protocol is an open standard for connecting AI assistants to software. The assistant gets a list of named tools, calls them with structured arguments and reads back real results, instead of guessing.
Why a brokerage cares
Agents already think in sentences. “Send Sarah three Dubai Hills options” becomes the WIYO steps it replaces: find the lead, match projects, build the proposal, send it on WhatsApp.
What stays the same
Every call runs as the agent who connected, with their permissions and their company's data. If they can't see it in WIYO, their assistant can't either.
Walkthrough
One sentence in. A finished workflow out.
Pick a job and watch the assistant break it into WIYO tool calls. Each call is a real tool with its real arguments, checked against the agent's role before it runs.
AgentFind Sarah three 2-bed off-plan options in Dubai Hills under AED 2.5M with a post-handover plan. Make her a proposal and send it on WhatsApp.
Call 1 of 5, leads_search. Found 1 lead(s).
An illustrative, scripted replay, not a live session. Tool names, arguments and result lines follow the live server; people, projects, IDs and figures are sample data.
Tool catalogue
39 tools. Six parts of the business.
An assistant only sees the tools the agent's role and plan allow, the same rule the app applies. Descriptions are condensed from the server's own tool definitions.
Writes changes data · 5 toolsPDF returns a document · 7 toolsEverything else only reads
Account
3 tools
Who is connected, what they may do, and what is waiting for them.
Every connected member · Home needs reports.view
account_Confirm the signed-in member: name, email, company and whether they are an owner.whoami account_List the WIYO permission keys this member holds.permissions_ summary home_Pending tasks, lead and listing insights and approvals: the same Home report as the app.dashboard
Leads
6 tools
The pipeline board, scoped and contact-veiled exactly as the member sees it.
Leads app · lead.view and up
leads_Search leads by name, phone, email, status or campaign.search leads_Fetch one lead, if the member may view it.get leads_The board's column keys and labels.stages leads_Lead counts per board column.pipeline_ summary leads_Move a lead to a board column: contacted, qualified, won…move_ stage leads_Add a note of up to 1,000 characters to a lead's timeline.add_ note
Off-plan
19 tools
The published UAE catalogue, Deal Studio, Deal Maker, portfolios and Command Center.
Off Plan app · plan feature + per-tool permissions
Catalogue
offplan_Browse published projects by city, beds, price, developer or free text.search offplan_Full details for one published project.get offplan_Compare 2–4 projects side by side: value, growth, scarcity.compare offplan_A client-safe comparison PDF for 2–4 projects.compare_ pdf offplan_The luxury brochure PDF for one project.brochure_ pdf
Matching
offplan_AI Match: rank projects for a lead or a brief. Deterministic, no LLM needed.match offplan_Turn a buyer brief into a ranked live shortlist: budget, beds, city, payment.deal_ maker offplan_A buyer-facing proposal PDF. Commission never appears on it.proposal_ pdf
Deal Studio
offplan_The full Deal Studio shortlist engine, with live unit pricing.studio_ match offplan_Save a shortlist as a proposal for a buyer, linked to their lead.studio_ proposal_ save offplan_The buyer PDF for a saved proposal, ready for WhatsApp.studio_ proposal_ pdf offplan_Saved Deal Studio proposals the member may reach.studio_ proposals_ list
Portfolio
offplan_A diversified basket for a budget and goal. Yields indicative, never guaranteed.portfolio_ build offplan_Saved investor portfolios from Portfolio Manager.portfolios_ list offplan_Open one saved portfolio.portfolio_ get offplan_An investor portfolio PDF, from a saved or a freshly built basket.portfolio_ proposal_ pdf
Market intelligence
offplan_Command Center headline figures and city mix, by emirate or district.market_ pulse offplan_Catalogue totals by city, district, development and sale status.intel_ stats offplan_Projects ranked by the agent's commission in AED. Needs commission access.commission_ radar
Properties
6 tools
The member's own listings, their portal spend and the PDFs that go with them.
Listings CRM · property.view and up
properties_Search the Listings CRM by status, type, community, beds or price.search properties_Fetch one listing, if the member may view it.get properties_Listing counts by status and Property Finder credits spent.summary properties_Credits, leads, cost per lead and recent leads for one listing.roi properties_A buyer-facing listing brochure, safe to send on WhatsApp.brochure_ pdf properties_An internal fact sheet with credits and leads. Not for buyers.sheet_ pdf
3 tools
Messages and documents from the agent's own business number, inside Meta's rules.
WhatsApp Pro · the member's own numbers only
wapro_WhatsApp Pro numbers connected to this member. Never a teammate's.accounts wapro_Send a message inside the 24-hour window, or an approved template outside it.send_ text wapro_Send a PDF or image, such as a proposal, inside the 24-hour window.send_ document
Playbook
2 tools
How the assistant finds its way: what is available, and in which order to use it.
Every connected member
wiyo_Which tools this member can use right now, after role and plan.capabilities wiyo_Step-by-step tool sequences: deal_to_whatsapp, portfolio_pitch, market_brief, listing_health, morning_ops.playbook
Connect
Connected in three steps. No keys. No code.
Each agent connects their own assistant to their own WIYO account. There are no keys to paste and nothing to deploy, and an owner can switch it off for any role.
Step 1: Copy the server URL
https://wiyo-backend-production.up.railway.app/mcpWIYO shows the same URL, with a setup guide, in Settings → AI assistants.
Step 2: Add it to your assistant
- In claude.ai or Claude Desktop, open Customize → Connectors.
- Choose Add custom connector. On Team and Enterprise plans an Owner may need to add it first, under Organization settings → Connectors.
- Paste the URL, name it WIYO and save. Leave OAuth on Claude's default detection.
Then press Connect and approve WIYO in the browser with your usual WIYO account.
Step 3: Sign in with WIYO and approve
Your assistant opens WIYO's consent screen. Sign in with your usual account, check that it names you, and approve. Then ask it who it is connected as.
AgentWho am I connected as in WIYO?
account_whoami
Connected to WIYO as Dana K. (dana@example.com) at Your Brokerage. Member access.
Sample data The agent's role needs the permission “Access AI MCP assistants”. Company owners turn it on or off per role.
Safety & control
It can do what the agent can do. Nothing more.
Permissions are not a line in the prompt. WIYO checks the agent's role, plan and company on every call, with the same rules the app uses.
Tools follow the role
A tool is listed and served only when the agent's role and plan hold the permission behind it. Without lead.view, there are no lead tools to call.
One company's data
Every call runs as the signed-in agent, through the same scoped queries as the app. Records stay inside their company and their record scope, and contact details stay veiled where the role veils them.
Commission stays internal
Commission figures are stripped from answers unless the role holds offplan.commission.view. Buyer proposal PDFs never show commission at all.
WhatsApp from your own number
WhatsApp tools only see the numbers the agent connected, never a teammate's. Free-form messages and PDFs go only inside Meta's 24-hour window, and contacts who opted out are refused.
A sign-in, not a key
Connecting is an OAuth sign-in with PKCE. The server URL carries no password or API key, and access tokens expire after 15 minutes.
Off means off
Disconnect in WIYO and the assistant's next call is refused. Switch AI assistants off for a role, suspend a member or switch an app off, and those calls stop too.
Five tools change anything. The other 34 read data or build a PDF.
WIYO doesn't add a confirmation step of its own. Each change is a separate, named call that the assistant shows in the chat, so its own tool approvals apply to these five.
| Tool | What it changes | Needs |
|---|---|---|
| leads_ | Moves a lead to another board column. | lead.stage.move |
| leads_ | Adds a note to a lead's timeline. | lead.activity.log |
| offplan_ | Saves a Deal Studio proposal for a buyer. | offplan.proposal.create |
| wapro_ | Sends a WhatsApp message or template from the member's number. | app.wapro |
| wapro_ | Sends a PDF or image on WhatsApp from the member's number. | app.wapro |
Give every agent an assistant that works inside WIYO.
Book a 30-minute walkthrough and we'll run the tools against the way your team actually works.
Building your own integration? The WIYO developer API is at console.wiyo.ae (opens in a new tab)