Happy Endpoint MCP Server

An MCP server that gives Claude, Cursor, and other MCP clients direct access to real-time UAE property data, retail product data, and travel pricing. Ask questions in plain language and the assistant queries the APIs itself.

"What's the rental yield on a 1-bed in JVC versus Dubai Marina?"
"What did apartments in Business Bay actually sell for this year?"
"Find off-plan projects in Dubai Hills under 2 million with less than 50% before handover."

Built and maintained by Happy Endpoint.

Install

Add to your MCP client config and restart it. No install step, npx fetches the package on first run.

{
  "mcpServers": {
    "happyendpoint": {
      "command": "npx",
      "args": ["-y", "happyendpoint-mcp"],
      "env": {
        "RAPIDAPI_KEY": "your_rapidapi_key"
      }
    }
  }
}

Get a key at rapidapi.com/user/happyendpoint. One key works across every API, and each has a free tier, but you subscribe to each one separately.

Related MCP server: Frostbyte MCP

Tools

Why this rather than the generic RapidAPI MCP server

RapidAPI hosts a generic MCP endpoint that exposes any API's raw endpoints, and for simple cases it is fine. Every Happy Endpoint API works with it:

{
  "mcpServers": {
    "Bayut": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.rapidapi.com",
               "--header", "x-api-host: uae-real-estate3.p.rapidapi.com",
               "--header", "x-api-key: YOUR_KEY"]
    }
  }
}

This server exists because four things go wrong when an assistant is handed raw endpoints.

1. Location IDs fail silently

The search endpoints take a numeric location ID. Pass a wrong one and the API returns a different area rather than an error. The answer looks completely plausible and is about the wrong place.

This is not hypothetical. A published ID table for these APIs had seven of nine areas wrong, with Business Bay and Palm Jumeirah transposed.

Here, tools take place names. IDs are resolved internally, and every response echoes which area was actually matched:

"resolvedLocation": { "name": "Jumeirah Village Circle (JVC)", "id": "5416" }

2. The endpoints disagree with each other

Four different response shapes for closely related data:

Given three shapes for "title", a model will read the wrong field and state the result confidently. Everything is normalised to one shape here.

3. Some questions are not a single endpoint

"Which area has the better rental yield" needs a sale search and a rent search per area, medians over both, and a division. compare_rental_yields does it in one call across up to eight areas. There is no endpoint for it.

4. Seventeen tools is too many

Models choose badly among seventeen near-identical endpoint names. This exposes ten task-shaped tools with descriptions that say when to use them, including the distinction that trips up most analysis: listings are asking prices, transactions are what property actually sold for.

Use the generic RapidAPI server if you want raw endpoint access. Use this one if you want an assistant to get the answer right.

Example output

compare_rental_yields across four Dubai areas, 1-bed apartments:

get_transactions for JVC over 12 months returns a computed summary alongside the rows:

{
  "totalTransactions": 3421,
  "summary": {
    "medianPricePerSqm": 15871,
    "minPricePerSqm": 7944,
    "maxPricePerSqm": 27013,
    "saleTypeBreakdown": { "Primary First Sale": 13, "Secondary Resale": 7 }
  }
}

Data sources

Full catalogue at happyendpoint.com/library.

Things worth knowing

Rental prices are annual. These portals quote yearly rent, not monthly. The server labels it so the assistant does not divide by twelve without noticing.

Asking prices are not transaction prices. search_properties returns what sellers want. get_transactions returns what buyers paid. For valuation, use transactions.

get_property_details is slow, routinely over 30 seconds. The server allows for it, but prefer search_properties when its fields suffice.

Gross yield is not net yield. Service charges, management, maintenance, and vacancy typically remove 2 to 3 percentage points in Dubai. The tool says so in its output.

Local development

git clone https://github.com/happyendpointhq/happyendpoint-mcp
cd happyendpoint-mcp
npm install
npm run build

RAPIDAPI_KEY=your_key node test-client.mjs

test-client.mjs connects over stdio, lists the tools, and calls several against the live API.

Point your client at the local build:

{
  "mcpServers": {
    "happyendpoint-dev": {
      "command": "node",
      "args": ["/absolute/path/to/happyendpoint-mcp/dist/index.js"],
      "env": { "RAPIDAPI_KEY": "your_key" }
    }
  }
}

FAQ

Do I need a paid plan?

No. Every API has a free RapidAPI tier, enough to try all the tools. Heavier use needs a paid plan on the specific APIs you use.

Why did a tool return a 403?

You are not subscribed to that particular API, or its quota is exhausted. The error names the API and links its subscription page. list_available_apis shows all of them.

Does it cover countries outside the UAE?

Property tools are UAE-focused today. The wider catalogue covers the UK, Spain, Turkey, Singapore, Japan, and the US, and those will be added as tools. See happyendpoint.com/library.

Is my API key sent anywhere except RapidAPI?

No. It stays in your MCP client config, is read from the environment, and is sent only as the x-rapidapi-key header to RapidAPI.

Can I use this without an MCP client?

Yes, through the language SDKs: happyendpoint-python and happyendpoint-js.

Related repos

• happyendpoint-python - Python client for the same APIs

• happyendpoint-js - TypeScript client

• bayut-api - endpoint documentation

• bayut-api-python-examples - runnable examples

• uae-real-estate-data-guide - every route to UAE property data

About Happy Endpoint

Happy Endpoint builds and maintains real-time data APIs for property portals, retailers, and marketplaces. All APIs are available on RapidAPI with a free tier.

• Catalogue: happyendpoint.com/library

• Datasets: happyendpoint.com/datasets

• Documentation: docs.happyendpoint.com

• Contact: happyendpointhq@gmail.com

Licence

MIT. See LICENSE.