# Melo — how to use (mcp.ai)

Connect your Melo account and use 3 tools for analytics straight from your AI agent. Connect with your own API key. Melo provides a comprehensive API for accessing real-time, deduplicated real estate listings and market analytics across France.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_melo?ms=1787295840000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `melo_get_cities`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/melo`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/melo/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/melo/get/cities` — Tool to retrieve a list of cities with optional filters. Use when you need to fetch available cities before processing location-specific data.
  - body: { page?: integer, search?: string, per_page?: integer, country_code?: string }
- `POST https://api.mcp.ai/api/melo/list/searches` — Retrieves all property searches saved by the authenticated user from the Melo API. Use this tool to: - View all saved property searches with their filtering criteria - Check notification settings for 
  - body: { page?: integer, title?: string, order_title?: string, notification_enabled?: boolean }
- `POST https://api.mcp.ai/api/melo/simulate/webhook` — Simulates sending a Melo webhook event to a specified endpoint for testing webhook integrations. This tool triggers the Melo API to send a sample webhook payload (either a property match or event noti
  - body: { endpoint: string, event_type: string }

## Example prompts
- "What can I do in Melo?"
- "Show me a summary of my Melo account"

## More
- Page: https://mcp.ai/melo
- Agent spec (llms.txt): https://mcp.ai/melo/llms.txt
- Postman collection: https://mcp.ai/melo/postman.json