iRumah MCP server
Connect your own AI to iRumah
Use Claude, ChatGPT or Gemini to search iRumah listings and new projects in plain language. Agents will later be able to work on their own listings the same way, with every important change approved inside iRumah.
- Not live yetPublic address (no login)
- Coming soonAgent and Agency access
What this is
A safe, limited set of iRumah tools for the AI app you already use.
MCP (Model Context Protocol) is an open standard that lets AI apps use tools from other services. Add iRumah to your AI app and it can look things up on iRumah for you.
Your AI understands your question and turns it into a search on iRumah. iRumah does not run the AI. Every result links back to irumah.com.my, where you can see the full listing and contact the Agent after signing in.
Nothing is live yet. The public address is being built and stays switched off until it is ready. Agent and Agency access will follow later. We will update this page when each one opens.
Two addresses
Pick the one that matches who you are. They are kept separate on purpose.
Public
Not live yetFor anyone. No login. Read only.
https://mcp.irumah.com.my/publicSearch public listings and new projects. Agent contact details are never included.
Agent
Coming soonFor iRumah Agents. Sign in with your iRumah Agent account.
https://mcp.irumah.com.my/agentYour own listings, COA, client requirements and projects. Agency tools appear here too, only for members of a white-label Agency.
The public address never asks you to sign in and has no tools that change anything. The Agent address always asks you to sign in on irumah.com.my, so your AI never sees your password.
Connect your AI
Add the address as a custom connector. Menu names can change; check your app’s help if they differ.
Claude
Web and desktop app, custom connector.
- Open Settings → Connectors.
- Choose Add custom connector.
- Name it iRumah and paste the public address.
- Select Add, then turn iRumah on from the tools menu in a chat.
Using Claude Code instead? Run:
claude mcp add --transport http irumah https://mcp.irumah.com.my/publicChatGPT
Developer mode connector.
- Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
- Choose Create to add a connector.
- Name it iRumah, paste the public address and choose No authentication.
- Confirm, then pick iRumah from the tools menu in a new chat.
Developer mode depends on your ChatGPT plan.
Gemini CLI
Config file.
- Open
~/.gemini/settings.json(create it if it is missing). - Add the iRumah server shown here.
- Restart Gemini CLI and run
/mcpto check the iRumah tools are listed.
Support in the Gemini app itself varies. Gemini CLI is the route we test.
{
"mcpServers": {
"irumah": {
"httpUrl": "https://mcp.irumah.com.my/public"
}
}
}Then try asking
- Find 3-bedroom condos for rent in Mont Kiara under RM 4,000/mo.
- Which new projects are there in Johor Bahru?
- Show me landed homes for sale in Penang between RM 800,000 and RM 1,200,000.
When the Agent address opens, use it the same way. Your AI app will send you to irumah.com.my to sign in and choose what it may do.
Permissions by tier
Your AI can never do more than you can do on the iRumah website right now.
User (public)
Not live yetNo loginAnyone can use these 5 read-only tools. Results only include public fields: Agent name, agency name and photo. No phone, WhatsApp, address, social links or email.
search_listingsRead onlySearch public listings by state, city, buy or rent, property type, price and bedrooms. Up to 12 results per page, 5 pages at most.
get_listingRead onlyPublic details of one listing, with its link on irumah.com.my.
search_projectsRead onlySearch new projects.
get_projectRead onlyPublic details of one new project.
list_locationsRead onlyValid state and city names, so your AI searches the right place.
Enquiries and saving listings stay on the website. To contact an Agent, open the listing link and sign in on iRumah.
Agent
Coming soonSign in requiredYou choose what the AI may do when you connect. Reading is ticked for you; each kind of change has to be ticked one by one. What the AI can actually do is the overlap of what you ticked, what you can do on the website right now, and your agency’s plan, checked again on every request.
Scopes
account.readWho you are, your agency and your quotaOn by defaultlistings.readYour listings, without owner private detailsOn by defaultcoa.readSafe details of COA listings shared with youOn by defaultprojects.readProjects and company listingsOn by defaultrequirements.readYour client requirements and matches, without client contact detailsOn by defaultlistings.writeCreate drafts and edit details. Public text only goes into draftsOff until you tick itlistings.statusHold, resume and extend. Publishing and closing need your approvalOff until you tick itlistings.sharingChange who a COA listing is shared with. Opening it to everyone needs your approvalOff until you tick itrequirements.writeCreate and edit client requirementsOff until you tick it
12 tools
get_my_accountRead onlyYour account, agency and quota.
list_my_listingsRead onlyYour listings with filters, up to 25 per page.
get_my_listingRead onlyOne of your listings.
search_coa_listingsRead onlySearch COA listings shared with you.
get_coa_listingRead onlyOne COA listing. Its description is shortened and marked as untrusted text.
search_projectsRead onlySearch projects.
get_projectRead onlyOne project.
list_requirementsRead onlyYour client requirements.
find_matchesRead onlyListings that match a requirement.
create_listing_draftDraft onlyCreate a draft listing. Nothing is published.
update_listing_draftDraft onlyEdit a draft. Changes to a live listing become a request you approve in iRumah.
set_listing_statusReversibleHold, resume or extend a listing.
Publishing, closing a listing, opening a COA listing to everyone, changing the public text of a live listing and bulk changes are never done directly. The AI only creates a request; you approve it in iRumah. Requests not approved within 24 hours are cancelled.
Agency
Coming soonWhite-label Agency members onlyExtra tools on the same Agent connection, shown only to members of a white-label Agency. Agents in the default iRumah organisation do not see them. Each tool is gated by your current Agency role: if an Agency Admin changes your role or a feature is switched off, the tool stops working on your next request.
Scopes
agency.readNeeds any Agency capability in your current roleOff until you tick itagency.announcements.sendNeeds the announcements.send capability in your current roleOff until you tick it
4 tools
get_agency_overviewRead onlyAgency name, your role, your capabilities and the features switched on.
list_agency_membersRead onlyMember names, roles and status. No emails or phone numbers. Agency Admins only.
list_agency_branchesRead onlyYour agency branches.
draft_agency_announcementNeeds your approvalDraft an announcement. It goes to all members only after you approve it in iRumah.
What the AI can never do
These stay on the website, done by a person, whatever the AI is asked.
- Delete anything
- See or share owner details: owner name and phone, exact unit, private coordinates, lowest price, private notes
- See customer contact details or customer conversations
- Show Agent phone, WhatsApp, address, social links or email on the public address
- Send WhatsApp messages or emails for you
- Manage Team members, change role templates, or appoint or remove Admins
- Change plan features, payments, credit or account settings
- Export all listings or customers, or export leads
Safety
You stay in control of every connection.
- Important actions need your approval inside iRumah. The AI cannot approve for you.
- Revoke anytime in Settings → Connected AI apps. You can see when each app was last used and its recent changes.
- Access ends at once when someone leaves the agency, is removed from a Team or their account is suspended. The next request fails.
- You sign in on irumah.com.my, never inside the AI app. Only known AI apps can connect, and the consent page shows the real address of the app asking.
- Your identity comes only from your sign-in. The AI cannot act as another Agent or another agency.
- Text written by other people, such as COA descriptions, is shortened and marked as untrusted so your AI treats it with care.
- Every change made through an AI app is recorded.
Usage limits
Kept low on purpose. If you hit one, wait and try again later.
Public
Shared by everyone using the public address.
- Per minute
- 30 requests
- Per day
- 1,000 requests
- Per search
- 12 results, 5 pages
Agent
Per connection.
- Reads
- 20 per minute
- Changes
- 5 per minute
- Per day
- 500 requests
Agency tools
Per connection.
- All limits
- Half of Agent
Public results may be up to 5 minutes old. There is no “export everything”.
Privacy (PDPA)
Know where your data goes.
When you use iRumah through an AI app, the results iRumah returns are sent to the AI provider you chose (for example Anthropic, OpenAI or Google) and handled under their terms.
We send the least data needed. Before an Agent connects, the consent page says clearly that data will go to that AI service. Owner details and customer contact details are never sent.
FAQ
Short answers to common questions.
Do I need an iRumah account?
Not for the public address. The Agent address needs an iRumah Agent account.
Why can’t my AI see Agent phone numbers?
Same rule as the website: Agent contact details are only shown to signed-in visitors on irumah.com.my. Open the listing link and sign in to contact the Agent.
Can the AI send an enquiry or message an Agent for me?
No. Enquiries, saved listings, WhatsApp and email all stay on the website.
Which AI apps work?
Claude (custom connector), ChatGPT (Developer mode connector) and Gemini CLI. Support in the Gemini app itself varies.
Can the AI publish or delete my listings?
It can never delete. It can create and edit drafts if you allow it. Publishing, closing and other important actions only happen after you approve them in iRumah.
What happens if I leave my agency or my role changes?
Your AI loses that access on its next request. Agency tools follow your current role, not the role you had when you connected.
How do I disconnect?
Revoke the app in Settings → Connected AI apps on iRumah. You can also remove the connector in your AI app.
Why did I get “try again later”?
The usage limits are kept low. The public limit is shared by everyone, so wait a minute and try again.
When will Agent and Agency access open?
There is no date yet. We will update this page when each one opens.
Contact
Questions, problems or a security concern.
Email us at hello@irumah.com.my.