# Melo MCP > Melo connects your AI client to on-chain real estate intelligence. It lets you run complex queries—like finding properties, tracking transaction history, or getting local market trends—all through natural conversation. Don't just list addresses; analyze the assets themselves via Melo. ## Overview - **Category:** real-estate - **Price:** Free - **Tags:** property-data, market-intelligence, on-chain-data, real-estate-analytics, asset-tracking ## Description Yo, you're connecting your AI client right into Melo's engine. This thing gives you deep access to on-chain real estate data and market intel—no more guessing games with property values. You can run complex queries in plain English; it’ll pull everything from current listings to the deepest blockchain transaction history. Don't just look up an address; you analyze the asset itself. **Analyzing Local Market Trends** You want to know what the neighborhood is doing? Use `get_market_insights` to query real estate trends for any spot or region you name. It pulls live data on property value changes and demand stats across whole areas. If you need help narrowing your search, first run `list_neighborhoods` to get a list of recognized neighborhoods within the city, then use that info to refine your market analysis. **Searching and Filtering Properties** Need to find something specific? The `search_properties` tool lets you look up listings using keywords or addresses across the entire database. You can also run `list_property_collections` if you're interested in curated groups of properties defined by the platform, or use `list_properties` for a general overview of available regional assets without any specific criteria. **Tracking Ownership History and Transactions** Understanding who owned what and when is crucial. Run `get_property_history` to generate a full timeline showing every recorded sale, price shift, and ownership transfer an asset has seen. To see multiple events at once, use `list_transactions`, which pulls a list of real estate transactions that happened in a given timeframe or area. **Listing Available Properties** When you need to know what’s actually available right now, the server handles it. You can pull comprehensive lists of current listings using `list_active_listings`, filtering by status—whether they're listed for sale or rent. If you just want a broad view of all assets currently on the books, use the general `list_properties` function. **Deep Asset Intelligence and Metadata** When you get down to brass tacks, Melo gives you the dirt. Use `get_property` with an address or unique ID to pull current, comprehensive details for a single property. For even deeper technical dives, run `get_onchain_metadata`, which retrieves the specific blockchain-recorded metadata attached to any given property ID. This lets your agent see the raw data backing up the listing. **Putting It All Together** You can combine these tools. You might start by running `search_properties` for a certain zip code, then use that result set to pull specific details with `get_property`, check its full life story using `get_property_history`, and finish up by querying the local market conditions with `get_market_insights`. The server handles connecting all these data points so your agent gets one clean answer. You'll also find you can list general transaction records using `list_transactions` for a specified region or time period, making it easier to audit an area’s entire financial history. ## Tools ### get_market_insights Runs a query to pull real estate market trend data for a specified location or region. ### get_onchain_metadata Retrieves the specific blockchain-recorded metadata associated with a property ID. ### get_property Pulls comprehensive, current details for one single identified property using its address or unique ID. ### get_property_history Generates a full timeline of recorded sales, price changes, and ownership transfers for an asset. ### list_active_listings Lists all properties currently marked as available for sale or rent in a specified area. ### list_property_collections Retrieves lists of curated or themed property groups defined by the platform. ### list_neighborhoods Provides a list of known neighborhoods within a given city, helping narrow market searches. ### list_properties Lists general real estate properties without specific search criteria, useful for broad regional overviews. ### list_transactions Lists multiple real estate transactions that occurred in a specified time frame or region. ### search_properties Searches for properties using keywords, addresses, or specific terms across the entire database. ## Prompt Examples **Prompt:** ``` List all active properties in Austin, TX. ``` **Response:** ``` Retrieving properties... I found 5 active listings in Austin, including '123 Main St' ($450k) and '456 Oak Ave' ($620k). ``` **Prompt:** ``` Show market insights for Miami. ``` **Response:** ``` Querying insights... Miami is currently seeing a 5% increase in property values with high demand in the Brickell neighborhood. ``` **Prompt:** ``` Get transaction history for property ID 987. ``` **Response:** ``` Fetching history... Property 987 has 3 recorded transactions, the most recent being a sale for 150 ETH in 2023. ``` ## Capabilities ### Analyze local market trends The agent retrieves real-time, localized property value changes and neighborhood demand statistics. ### Retrieve specific asset metadata You can pull technical on-chain details for any given property ID or address. ### Search and filter properties The server finds listings by text search, filtering results across different regions simultaneously. ### Track ownership history It provides a timeline of recorded sales and financial events associated with an asset. ### List all available properties The agent pulls comprehensive lists of current listings, organized by status (for sale/rent) or collection type. ## Use Cases ### Assessing investment risk on a new parcel. A developer needs to assess the viability of a raw plot. They ask their agent to run `list_neighborhoods` for the area, then use those results with `get_market_insights` to see if current demand supports high-end residential pricing. Finally, they check nearby assets using `search_properties` to gauge competition. ### Verifying a property's true value. A client is considering buying an older home. Instead of just trusting the listing price, they ask their agent to run `get_property_history` and cross-reference the sale data with `get_onchain_metadata`. This reveals if previous sales were inflated or undervalued. ### Tracking a corporate portfolio's assets. A portfolio manager needs to audit 50 different assets. They use `list_property_collections` first, then iterate through the results using `get_onchain_metadata` for each one. This ensures every asset in their collection has verifiable digital proof of existence and ownership. ### Finding all available inventory quickly. A listing agent needs to know everything available right now in a market. They run `list_active_listings` for the region, then use `search_properties` to filter those results by price range or specific features (e.g., 'pool' and 'over $2M'). ## Benefits - **Full Audit Trail:** You get a clear picture of an asset's life cycle by using `get_property_history`. This tool pulls every recorded sale and price adjustment, letting you build a complete financial timeline—that’s key for due diligence. - **Local Market Context:** Don't guess about value. Use `get_market_insights` to get real-time data on neighborhood demand. It gives you the macro view that simple property listings miss, telling you *why* a price point might be high or low. - **Deep Filtering Power:** Forget clicking through multiple pages. By running `search_properties`, your agent runs cross-database queries, letting you find exactly what you need—a three-bedroom condo in zip code 90210 that transacted under $1M last year. - **On-Chain Verification:** The `get_onchain_metadata` tool connects the physical asset to its digital record. This verifies ownership and transaction details directly from the blockchain source, adding a layer of security you can't get anywhere else. - **Broad Scope Listing:** Need an overview? Running `list_properties` or `list_active_listings` quickly gives you a comprehensive inventory check for a region without needing to know specific addresses first. ## How It Works The bottom line is: you talk to your AI client, and it handles the complex, multi-step database calls itself. You get a single, actionable report. 1. Subscribe to the Melo server and enter your API Key into your AI client. 2. Ask your agent a natural language query (e.g., 'What's the market trend in Miami?'). 3. The agent executes the necessary tools (`get_market_insights`, `list_properties`) against the data and presents the synthesized answer. ## Frequently Asked Questions **How do I find my Melo API Key?** Log in to Melo, go to your Dashboard settings, and look for the API section to generate or copy your key. **What is 'on-chain' property data?** This refers to real estate information recorded on a blockchain, providing a transparent and immutable history of ownership and events. **Is my real estate data secure?** Absolutely. Your token is encrypted at rest and injected securely at runtime. **What happens if I run `list_active_listings` too many times?** The server enforces standard rate limits to ensure system stability. If you exceed the allowed calls, your agent will receive a 429 error code and must wait before attempting to retrieve more listings. **How can I refine my search using `search_properties`?** You can narrow results by adding specific parameters like zip codes, keywords, or price ranges into the search term. The tool passes these filters directly to the underlying property database. **What data structure does `get_onchain_metadata` return?** The output is a structured JSON object detailing verifiable metadata. This includes smart contract addresses, token IDs, and all recorded on-chain timestamps for the asset in question. **Does `get_market_insights` need a city or a neighborhood name?** You must provide at least a valid city to run this tool. Providing a specific neighborhood helps localize the data, giving you hyper-specific market trends instead of general city averages. **How do I combine property details and its history using multiple tools?** You first call `get_property` to retrieve the base ID. Then, pass that exact ID into the `get_property_history` tool. This sequence reliably pulls both static data and all historical records.