# Happy Endpoint

> Happy Endpoint is a freemium MCP server for analytics and data. UAE property, retail and hotel data by place name, via RapidAPI-backed tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://happyendpoint.com
- **Repository:** https://github.com/happyendpointhq/happyendpoint-mcp
- **MCP Registry name:** io.github.happyendpointhq/happyendpoint-mcp
- **Categories:** analytics and data, maps and travel
- **Listing updated:** 2026-11-15

## About

Place names, not numeric IDs, are the main design choice. The README explains that the underlying property endpoints silently return a different area when given a wrong location ID, and says a published ID table had seven of nine areas wrong. The tools resolve IDs internally and echo which area was matched.

It also normalises response shapes that disagree between endpoints, and offers compare_rental_yields, which runs sale and rent searches per area, takes medians and divides, across up to eight areas in one call. Example questions include rental yield for a 1-bed in JVC versus Dubai Marina, and off-plan projects in Dubai Hills.

It runs over stdio with npx and needs a RapidAPI key; one key works across Happy Endpoint's APIs, each with a free tier, but you subscribe to each separately. The README labels it beta, a 0.x release whose tools may change.

## Features

- **Place-name search:** Resolves locations internally and reports the matched area.
- **Normalised responses:** Maps differing endpoint shapes into one structure.
- **Rental yield comparison:** Computes gross yield across up to eight areas in one call.
- **Property data:** Listings, details, transactions, off-plan projects and agents.
- **Retail and hotels:** Product search and hotel search by destination and dates.

## Good for

- Compare rental yields between Dubai areas
- Check recent sale prices in a building or area
- Find off-plan projects under a price
- Look up agents active in an area

## Install

### Claude Code (Terminal)

```sh
claude mcp add happyendpoint-mcp --env RAPIDAPI_KEY='<RAPIDAPI_KEY>' -- npx -y happyendpoint-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "happyendpoint-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "happyendpoint-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "happyendpoint-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "happyendpoint-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "happyendpoint-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "happyendpoint-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "happyendpoint-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "happyendpoint-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "happyendpoint-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "happyendpoint-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}
```

## Tools

- `search_properties`: Property listings for sale or rent by area, price, bedrooms and type.
- `get_property_details`: Full record for one property with amenities and agency.
- `get_transactions`: Recorded sale transactions with price per sqm and sale type.
- `compare_rental_yields`: Gross yield across several areas, computed.
- `search_off_plan`: Off-plan and under-construction developments.
- `find_agents`: Agents by area with agency and performance badges.
- `find_locations`: Search areas, communities and buildings by name.
- `search_products`: Retail product search across beauty and home categories.
- `search_hotels`: Hotel search by destination and dates.
- `list_available_apis`: What the server can reach and where to subscribe.

## FAQ

### What do I need to run it?

A RapidAPI key set as RAPIDAPI_KEY, with npx to launch the package.

### Is it stable?

No. The README says it is a beta 0.x release and tools may change before 1.0.

### Is each API free?

Each has a free tier, but you subscribe to each API separately.

### Why not use a generic API proxy?

The README cites silent wrong-area IDs and inconsistent response shapes.

### Is Happy Endpoint free?

Happy Endpoint has a free plan, with paid plans for more usage or features.

### How do I add Happy Endpoint to Claude Code?

Run this command in your terminal: claude mcp add happyendpoint-mcp --env RAPIDAPI_KEY='<RAPIDAPI_KEY>' -- npx -y happyendpoint-mcp

### What are the best alternatives to Happy Endpoint?

The closest alternatives to Happy Endpoint are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/happy-endpoint
