MCP server Go to irumah.com.my

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.

See how to connect

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 yet

For anyone. No login. Read only.

https://mcp.irumah.com.my/public

Search public listings and new projects. Agent contact details are never included.

Agent

Coming soon

For iRumah Agents. Sign in with your iRumah Agent account.

https://mcp.irumah.com.my/agent

Your 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.

  1. Open Settings → Connectors.
  2. Choose Add custom connector.
  3. Name it iRumah and paste the public address.
  4. Select Add, then turn iRumah on from the tools menu in a chat.

Using Claude Code instead? Run:

Terminal
claude mcp add --transport http irumah https://mcp.irumah.com.my/public

ChatGPT

Developer mode connector.

  1. Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
  2. Choose Create to add a connector.
  3. Name it iRumah, paste the public address and choose No authentication.
  4. Confirm, then pick iRumah from the tools menu in a new chat.

Developer mode depends on your ChatGPT plan.

Gemini CLI

Config file.

  1. Open ~/.gemini/settings.json (create it if it is missing).
  2. Add the iRumah server shown here.
  3. Restart Gemini CLI and run /mcp to check the iRumah tools are listed.

Support in the Gemini app itself varies. Gemini CLI is the route we test.

settings.json
{
  "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 login

Anyone 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 only

    Search 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 only

    Public details of one listing, with its link on irumah.com.my.

  • search_projectsRead only

    Search new projects.

  • get_projectRead only

    Public details of one new project.

  • list_locationsRead only

    Valid 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 required

You 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 default
  • listings.readYour listings, without owner private detailsOn by default
  • coa.readSafe details of COA listings shared with youOn by default
  • projects.readProjects and company listingsOn by default
  • requirements.readYour client requirements and matches, without client contact detailsOn by default
  • listings.writeCreate drafts and edit details. Public text only goes into draftsOff until you tick it
  • listings.statusHold, resume and extend. Publishing and closing need your approvalOff until you tick it
  • listings.sharingChange who a COA listing is shared with. Opening it to everyone needs your approvalOff until you tick it
  • requirements.writeCreate and edit client requirementsOff until you tick it

12 tools

  • get_my_accountRead only

    Your account, agency and quota.

  • list_my_listingsRead only

    Your listings with filters, up to 25 per page.

  • get_my_listingRead only

    One of your listings.

  • search_coa_listingsRead only

    Search COA listings shared with you.

  • get_coa_listingRead only

    One COA listing. Its description is shortened and marked as untrusted text.

  • search_projectsRead only

    Search projects.

  • get_projectRead only

    One project.

  • list_requirementsRead only

    Your client requirements.

  • find_matchesRead only

    Listings that match a requirement.

  • create_listing_draftDraft only

    Create a draft listing. Nothing is published.

  • update_listing_draftDraft only

    Edit a draft. Changes to a live listing become a request you approve in iRumah.

  • set_listing_statusReversible

    Hold, 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 only

Extra 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 it
  • agency.announcements.sendNeeds the announcements.send capability in your current roleOff until you tick it

4 tools

  • get_agency_overviewRead only

    Agency name, your role, your capabilities and the features switched on.

  • list_agency_membersRead only

    Member names, roles and status. No emails or phone numbers. Agency Admins only.

  • list_agency_branchesRead only

    Your agency branches.

  • draft_agency_announcementNeeds your approval

    Draft 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.