# MCP access to Happy Endpoint APIs

Every Happy Endpoint API works as an MCP server, with no extra setup on our side and
nothing to install. RapidAPI runs an MCP gateway at `https://mcp.rapidapi.com`; pointing it at
one of our API hosts exposes that API's endpoints as MCP tools.

## Configuration

Add this to your MCP client config, replacing the host with the API you want and
`<your-rapidapi-key>` with your key:

```json
{
  "mcpServers": {
    "happy-endpoint-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-rapidapi-key>"
      ]
    }
  }
}
```

Add one entry per API you want available. Each API's endpoints become individual tools,
so a client can call them directly without you writing any glue code.

## Getting a key

Subscribe to the API on RapidAPI and copy the key from your RapidAPI dashboard. Most
APIs include a free tier for testing. See https://happyendpoint.com/auth.md.

## Available APIs

| API | RapidAPI host (`x-api-host`) | Endpoints | Details |
|---|---|---|---|
| UAE Real Estate API | `uae-real-estate-api.p.rapidapi.com` | 10 | https://happyendpoint.com/library/uae-realestate-api |
| Bayut UAE Data | `uae-real-estate3.p.rapidapi.com` | 10 | https://happyendpoint.com/library/bayut-api |
| PropertyFinder UAE Data | `uae-real-estate-property.p.rapidapi.com` | 15 | https://happyendpoint.com/library/propertyfinder-api |
| Rightmove UK API | `rightmove-uk-real-estate-data.p.rapidapi.com` | 11 | https://happyendpoint.com/library/rightmove-uk |
| Sephora API | `real-time-sephora-api.p.rapidapi.com` | 11 | https://happyendpoint.com/library/sephora-api |
| Morningstar API | `morningstar13.p.rapidapi.com` | 8 | https://happyendpoint.com/library/morningstar |
| Ikea Pro API | `ikea-api-pro.p.rapidapi.com` | 6 | https://happyendpoint.com/library/ikea-pro |
| Klarna Ecom API | `klarna7.p.rapidapi.com` | 9 | https://happyendpoint.com/library/klarna-ecom |
| Tesco Data API | `tesco-data-api.p.rapidapi.com` | 7 | https://happyendpoint.com/library/tesco-data |
| H&M API | `h-m-hennes-mauritz1.p.rapidapi.com` | 6 | https://happyendpoint.com/library/hm-api |
| Kohls Data API | `kohls-com.p.rapidapi.com` | 6 | https://happyendpoint.com/library/kohls-data |
| Priceline Pro API | `priceline-api-pro.p.rapidapi.com` | 6 | https://happyendpoint.com/library/priceline-pro |
| Fotocasa API | `fotocasa3.p.rapidapi.com` | 3 | https://happyendpoint.com/library/fotocasa-api |
| Idealista API | `idealista17.p.rapidapi.com` | 14 | https://happyendpoint.com/library/idealista-api |
| PropertyFinder - Search by URL | `propertyfinder1.p.rapidapi.com` | 2 | https://happyendpoint.com/library/propertyfinder-api-2 |
| 99.co Singapore API | `99-co-sg-api.p.rapidapi.com` | 14 | https://happyendpoint.com/library/99co-api |
| Aqar Saudi Arabia API | `aqar.p.rapidapi.com` | 22 | https://happyendpoint.com/library/aqar-api |
| Hepsiemlak Turkey API | `hepsiemlak-turkish-property-api.p.rapidapi.com` | 11 | https://happyendpoint.com/library/hepsiemlak-api |
| Njuškalo Croatia API | `njuskalo.p.rapidapi.com` | 20 | https://happyendpoint.com/library/njuskalo-api |
| SUUMO Japan Real Estate API | `suumo-japan-real-estate.p.rapidapi.com` | 21 | https://happyendpoint.com/library/suumo-api |
| Emlakjet Turkey API | `emlakjet.p.rapidapi.com` | 18 | https://happyendpoint.com/library/emlakjet-api |
| Yad2 Israel API | `yad21.p.rapidapi.com` | 24 | https://happyendpoint.com/library/yad2-api |
| Auction.com API | `auction-com-real-estate-api.p.rapidapi.com` | 12 | https://happyendpoint.com/library/auction-com-api |
| Gumtree UK API | `gumtree2.p.rapidapi.com` | 16 | https://happyendpoint.com/library/gumtree-api |
| Realtor.com Data API | `realtor-com-data-api.p.rapidapi.com` | 37 | https://happyendpoint.com/library/realtor-com-api |
| Vrbo API | `vrbo2.p.rapidapi.com` | 21 | https://happyendpoint.com/library/vrbo-api |
| 28Hse Hong Kong Property API | `28hse-property-api.p.rapidapi.com` | 13 | https://happyendpoint.com/library/28hse-api |

Each endpoint is exposed as one MCP tool with its parameters described in the tool
schema. The gateway additionally exposes each API's `status` health check, so the tool
count you see in your client is one higher than the endpoint count above.

## Notes

- Calls made through the gateway count against your RapidAPI plan exactly as direct
  HTTP calls do. Listing tools is metadata and does not consume quota.
- Rate limit headers come back on every response as `x-ratelimit-requests-remaining`.
- Bulk datasets and daily data feeds are not MCP surfaces. They are files and sheets,
  not request-time APIs. See https://happyendpoint.com/datasets and https://happyendpoint.com/data-feeds.

Walkthrough with a worked example: https://happyendpoint.com/blog/data-apis-as-mcp-servers

Full catalog: https://happyendpoint.com/llms.txt - machine-readable API list: https://happyendpoint.com/api-catalog.json