developer-toolsapi_key

Melo

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

Verdict

Melo MCP connects your workspace to Melo's location and search APIs. @mention it to autocomplete addresses, filter cities by region, list saved searches, or test webhook payloads without leaving chat. Developers building location-aware features get the most value — you can prototype geocoding flows, validate address inputs, and debug webhook integrations directly in a Space. Auth requires an API key from your Melo dashboard. The MCP surfaces four tools; coverage depends on your Melo plan's data regions.

Common use cases

  • Autocomplete addresses during form design reviews
  • Validate city names before batch geocoding
  • List saved searches for API audit
  • Test webhook payloads in staging environments
  • Filter location data by country or type

Integration

Vendor
Melo
Category
developer-tools
Auth
API_KEY
Tools
4
Composio slug
melo

Tools

  • 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.

  • List Searches

    Tool to list all searches. use after authenticating to retrieve the user's searches.

  • Location Autocomplete

    Tool to fetch location autocomplete suggestions. use when you have a partial location query and need possible matching locations from melo api. supports filtering by country and location type. use after forming the query string.

  • Simulate Webhook

    Tool to simulate sending a webhook event. use when testing webhook integrations. call after configuring endpoint and payload.

Setup

Setup guide

  1. 11. In Switchy, open Settings and navigate to Integrations. 2. Find Melo in the MCP directory and click Connect. 3. You'll be prompted to paste your Melo API key — retrieve it from your Melo account dashboard under API Settings. 4. Grant the connection and Switchy will verify the key against Melo's API. 5. Once connected, open any Space and type '@Melo' to confirm the MCP responds. 6. Test the connection by asking '@Melo list my searches' or '@Melo autocomplete 123 Main' — if results appear, setup is complete. 7. To invoke a specific tool, address Melo directly in your prompt and describe the task; the MCP routes to the appropriate endpoint.

What teammates see: by default, memories from Melo are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Autocomplete Address

@Melo autocomplete '1600 Pennsylv' and show the top 3 matches with full addresses and coordinates
Open in a Space →

List Available Cities

@Melo get all cities in Canada and group them by province, then count how many are in each region
Open in a Space →

Retrieve Saved Searches

@Melo list all my searches from the past week and summarize the most common location types queried
Open in a Space →

Simulate Webhook Event

@Melo simulate a webhook to https://staging.example.com/hooks/melo with a sample location update event and show the response
Open in a Space →

Filter Locations by Type

@Melo autocomplete 'San' filtered to city type only in the United States and return the top 5 results
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@melo show me all my saved searches and their current status

Output

Here are your 3 active searches in Melo: 1. **Senior Backend Engineer - Berlin** (created 2 days ago): 47 new matches since last check, monitoring 12 job boards 2. **Product Manager - Remote EU** (created 1 week ago): 23 new matches, monitoring 8 job boards 3. **DevOps Lead - Amsterdam** (created 3 weeks ago): 15 new matches, monitoring 10 job boards All searches are running with daily refresh cycles. The Berlin search has the highest match velocity right now.

Notes

This example shows how the MCP surfaces your existing search configurations and their activity. Requires a valid Melo API key with read access to your account's searches. The match counts and board coverage reflect real-time state, so numbers will vary by when you last synced.

Prompt

@melo I'm looking for jobs in 'San Fran' — what locations does that match?

Output

Melo's location autocomplete found these matches for 'San Fran': 1. **San Francisco, California, United States** (city) 2. **San Francisco Bay Area, California, United States** (metro area) 3. **San Francisco County, California, United States** (county) The first option (city proper) is most specific. If you're open to surrounding areas like Oakland or San Jose, choose the Bay Area option. I can help you create a search using any of these location filters.

Notes

Demonstrates how the MCP resolves ambiguous location queries before you commit to a search configuration. Useful when setting up new job searches to ensure you're targeting the right geographic scope. The autocomplete supports country and location-type filters if you need to narrow results further.

Prompt

@melo simulate a webhook event for my staging endpoint to test the integration before I go live

Output

Webhook simulation sent to your staging endpoint: **Endpoint:** `https://staging.yourapp.com/webhooks/melo` **Event Type:** `search.new_matches` **Payload:** Sample event with 3 mock job matches for a Berlin-based search **Response:** 200 OK (received in 340ms) Your endpoint successfully acknowledged the test event. The payload structure matches what you'll receive in production when new job matches arrive. You can now enable live webhooks with confidence that your handler is working.

Notes

This example shows the MCP's webhook testing capability, which lets you validate your integration without waiting for real job-match events. Requires your Melo account to have a configured webhook endpoint. The simulation uses realistic payload structure but synthetic data, so you can safely test error handling and parsing logic.

Use-case deep-dives

Real estate listing ingestion pipeline

When Melo handles location normalization for property data

A 3-person proptech startup ingests rental listings from 12 scrapers that format addresses inconsistently. Melo's location autocomplete and city lookup tools standardize this mess before the data hits their database. The team runs a nightly batch job that calls the autocomplete endpoint for each raw address string, then validates the returned city against Melo's canonical list. This works cleanly up to about 5,000 listings per night—beyond that, you'll want to cache city lookups or move to a bulk geocoding service. The webhook simulator is useful during initial integration testing, but most teams stop using it after the first week. If your address data is already clean or you're under 500 records, skip Melo and use a free geocoding API. For messy multi-source location data at small scale, Melo's normalization is worth the API key.

Customer support ticket routing by region

Melo for triaging support requests to local reps

A 6-person SaaS support team routes tickets to regional reps based on customer location. When a ticket arrives with a city name or partial address, the team's Switchy workspace calls Melo's location autocomplete to resolve it to a canonical city, then matches that city to a rep's coverage area. This setup works because Melo returns structured location data (city, country, type) that maps cleanly to the team's routing rules. The list searches tool lets the team audit which location queries have been run, useful for spotting patterns in misspelled city names or ambiguous queries. If your ticket volume is under 200 per day and you need sub-country routing, Melo handles it without custom geocoding logic. Above that volume or if you only route by country, a simpler IP geolocation service is faster and cheaper.

Event planning vendor discovery workflow

When Melo's city filters speed up venue research

A 2-person event agency researches venues and vendors across 30 US cities for corporate clients. They use Melo's get cities tool with country and name filters to quickly pull lists of cities in a target region, then feed those city names into their vendor database queries. This eliminates the manual step of typing city names or copying from a spreadsheet. The location autocomplete tool helps when a client mentions a neighborhood or metro area instead of an exact city—Melo resolves it to the canonical city name the vendor database expects. The workflow saves about 15 minutes per event proposal. If your research spans fewer than 10 cities or you already have a static city list, Melo is overkill. For agencies doing frequent multi-city research with varied location inputs, the autocomplete and filter combo justifies the API key and four-tool overhead.

Frequently asked

What does the Melo MCP do in Switchy?

The Melo MCP connects your Switchy workspace to Melo's location and search APIs. Your AI assistants can autocomplete addresses, retrieve city lists with filters, pull your saved searches, and simulate webhook events for testing integrations. It's useful if your team builds location-aware features or needs to validate Melo webhook payloads before deploying.

Do I need a Melo API key to use this MCP?

Yes. You authenticate with an API key from your Melo account. Whoever connects the MCP in Switchy needs access to generate or copy that key from Melo's dashboard. The key stays scoped to whatever permissions your Melo account has—Switchy doesn't request OAuth scopes here, so check your Melo plan limits and endpoint access before connecting.

Can the Melo MCP write data or only read it?

It's mostly read-only. The MCP fetches cities, autocomplete suggestions, and your saved searches. The one write-like action is simulating webhooks, which sends test payloads to an endpoint you specify—it doesn't modify your Melo account data. If you need to create or update searches in Melo, you'll have to do that directly in their app or via their full API.

How is this different from calling the Melo API myself?

Calling the API yourself gives you full control and lower latency for production workflows. The MCP is faster for ad-hoc queries inside Switchy—your team can ask an assistant "show me cities in Germany" without writing code. Use the MCP for exploration and internal tooling; use the direct API for customer-facing features or high-volume automation.

Who on my team should connect the Melo MCP?

Whoever owns your Melo API key and understands which endpoints your team needs. Typically a backend engineer or the person managing your location data integrations. Once connected, any Switchy user in your workspace can invoke the tools through assistants, so make sure your Melo account permissions align with what you want the whole team to access.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.