# Melo AI integration on Definable

> Melo provides a comprehensive API for accessing real-time, deduplicated real estate listings and market analytics across France.

## What this connects

Melo provides a comprehensive API for accessing real-time, deduplicated real estate listings and market analytics across France.

Vendor: https://www.melo.io/

## Tools available

**3** tools available. First 3:

- `MELO_GET_CITIES` — 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.
- `MELO_LIST_SEARCHES` — 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 each search - Paginate through large lists of searches - Filter searches by title or notification status - Sort searches alphabetically by title Returns search details including location filters, budget ranges, property types, and notification configurations. The API uses Hydra collection format for pagination.
- `MELO_SIMULATE_WEBHOOK` — 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 notification) to your specified HTTPS endpoint. Useful for testing webhook handlers before going live. The API will send realistic property data including advert details, contact information, and geographic data to your endpoint. Use this when you need to test how your webhook endpoint handles Melo notifications.

## Auth

Auth schemes: `API_KEY`.

## How agents use Melo

Inside a Definable workflow, Melo is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Melo** — the Researcher (GPT-5.5) pulls context from Melo (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Melo** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Melo (create record, post message, draft email).
- **Designer / Engineer → Distributor → Melo** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Melo (attach file, open PR comment, post status).

The Verifier checks every Melo call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- analytics — https://definable.ai/apps/category/analytics/

## Related

- HTML page: https://definable.ai/apps/melo/
- Same category (analytics): https://definable.ai/apps/category/analytics/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt