# Nestoria MCP > Nestoria connects your AI agent directly to a global property database. Use it to find houses or apartments for sale or rent across major markets like the UK, Spain, France, Germany, and Australia. You can filter listings by price range, number of bedrooms, specific keywords (like 'pool' or 'garden'), and even coordinates. It centralizes real estate data from dozens of regional portals into one chat command. ## Overview - **Category:** real-estate - **Price:** Free - **Tags:** property-search, real-estate-listings, home-buying, rentals, housing-market ## Description You connect your AI agent to the **Nestoria MCP Server** using the `search_listings` tool. This lets you run deep searches across global real estate databases, pulling listings for sale or long-term rent from major markets like the UK, Spain, France, Germany, and Australia—all in one command. You never have to jump through dozens of regional property portals again; your agent gathers and filters everything right there in the chat. The **`search_listings`** tool handles all your search needs. When you need properties, you simply give it a city name or specific geographical coordinates, and it finds every relevant listing across multiple countries. You're not limited to one region; you can find stuff worldwide. You can really nail down what you’re looking for by filtering results based on core property details. Do you know your budget? Tell the agent your desired price range. Need space? You can set a minimum number of bedrooms, or specify if it has to be a house or just a flat. The more specific you are, the better the search. Want to make sure you're only seeing what matters? You tell it whether you’re looking for properties to purchase or if you need something available only for long-term lease. It keeps your intent straight—you won't get mixed results. For advanced searches, you apply specific keywords directly to the listing descriptions. Want a pool, a garden, or maybe a private courtyard? Just use those terms, and it drills down into the listings that have them. This is way better than just scrolling through thousands of irrelevant photos. When the results come back, you can control how they're organized. You tell the agent exactly how you want to see things sorted—by price (high or low), by which bedroom count is listed, or even by the date it hit the market. This means you always see what’s most relevant or urgent right at the top. The **`search_listings`** tool aggregates real estate data from dozens of regional sources into one conversation thread. You pass location parameters—a city name, a pair of coordinates—and it executes the query. Then, you can refine that initial sweep by setting price minimums and maximums, narrowing the search to properties with at least two bedrooms for example. It distinguishes between intent, so you tell your agent if you're buying or renting. It supports searching across major global markets. Whether it’s a listing in the UK or one popping up in Brazil, you get the same powerful filtering capability. You can apply advanced keywords like 'renovated kitchen' or 'balcony view,' forcing the search engine to check the full description text for those exact phrases. The tool lets you sort results by relevance score first, which is usually what you want, but you can switch that out for sorting purely by price point or even just by date uploaded. It centralizes data from sources that previously required multiple logins and manual filtering. Your agent runs the search, processes the location, applies all your filters—from property type to keyword—and gives you a single, sorted list of actionable listings. You don't need separate tools for searching international markets; it handles the complexity of varied global databases automatically. ## Tools ### search_listings Searches for real estate listings on Nestoria using location, filters, and keywords. ## Prompt Examples **Prompt:** ``` Search for houses to buy in London with at least 3 bedrooms. ``` **Response:** ``` I've found several houses in London with 3+ bedrooms. For example, a Victorian terrace in Fulham for £1,250,000 and a modern house in Greenwich. Would you like to see more details on these? ``` **Prompt:** ``` Find apartments for rent in Madrid between 1000 and 2000 euros. ``` **Response:** ``` Searching Nestoria Spain... I found 12 apartments in Madrid within your budget. Most are located in the Centro and Chamberí districts. Should I list them by price or newest first? ``` **Prompt:** ``` Look for properties in Paris with the keyword 'garden'. ``` **Response:** ``` I've filtered listings in Paris for 'garden'. I found a beautiful ground-floor flat in the 16th arrondissement and a house in Montmartre with a private courtyard. Would you like the full descriptions? ``` ## Capabilities ### Search listings globally You give a city name or coordinates, and it finds all relevant properties across multiple countries. ### Filter by core property details It limits search results based on criteria like price range, minimum number of bedrooms, and if the listing is a house or flat. ### Differentiate buy vs. rent You tell it whether you are looking for properties to purchase or those available only for long-term lease. ### Apply advanced keywords It searches the listing descriptions using specific terms like 'pool,' 'garden,' or 'private courtyard.' ### Order results by priority You specify how you want the listings sorted—by price, newest date, or relevance—to see what matters most first. ## Use Cases ### Tracking an Investment Opportunity An investor needs to monitor the market in Paris. They ask their agent to use `search_listings`, specifying 'France', 'Paris', and a price range of £1M-£3M, sorted by 'newest'. The agent returns fresh listings instantly, letting them track market movement without checking multiple sites. ### Finding a Family Home Abroad A family is moving to Brazil. They ask the agent to use `search_listings` for 'Brazil', specifying 'houses' and keywords like 'garden' and '4 bedrooms'. The tool returns localized listings, helping them narrow down suitable neighborhoods fast. ### Comparing Rental Markets A client is deciding between Madrid and Barcelona. They use `search_listings` twice: once for rent in Madrid (1000-2000 euros) and once for rent in Barcelona. The agent compiles both sets of results, letting the user compare market density side-by-side. ### Quick Local Search You know a general area but don't have the exact city name. You pass coordinates to `search_listings`. The tool uses those specific points to pull up listings, giving you immediate results where generic searching fails. ## Benefits - Stop jumping between dozen of real estate portals. Nestoria aggregates and filters listings across countries like the UK, Spain, France, Germany, Italy, Brazil, and Australia into a single chat flow. - The `search_listings` tool lets you use keywords ('pool', 'garden') to narrow results, bypassing generic searches for specific lifestyle needs in any major city. - It handles both buying and renting in one go. Just specify your intent when calling `search_listings`, saving you the time of running separate searches for sale vs. lease properties. - Need market insights? You can sort results by price (high/low) or relevance, giving you immediate visibility into which listings are currently most popular or undervalued. - Coordinates work too. Instead of guessing a neighborhood name, you pass precise coordinates to `search_listings` for highly accurate property targeting. ## How It Works The bottom line is: you describe your ideal property in natural language, and the server handles all the cross-country data retrieval and filtering automatically. 1. First, call `search_listings` and provide the initial parameters: location (city/coordinates), transaction type (buy/rent), and any core filters (e.g., min bedrooms). 2. Next, you refine the search by adding advanced constraints like price ranges or specific keywords ('garden'). The agent passes these updates to the tool. 3. Finally, it returns a curated list of properties that match every criteria. You can then ask it to sort those results by 'newest' or 'price low-to-high' for final review. ## Frequently Asked Questions **Can I search for properties using specific coordinates instead of a city name?** Yes! Use the `search_listings` tool and provide the `centre_point` parameter with latitude and longitude separated by a comma (e.g., '51.50,-0.12'). **How do I filter results by price and property type?** You can use the `price_min`, `price_max`, and `property_type` (e.g., 'house' or 'flat') parameters within the `search_listings` tool to narrow down your search results. **Is it possible to see the newest listings first?** Absolutely. Set the `sort` parameter to 'newest' when calling the `search_listings` tool to get the most recent entries at the top of your results. **When using the `search_listings` tool, do I need to provide an API key or just a User Agent?** You only need the optional User Agent string for identification. This helps Nestoria track usage and is not required for basic functionality of the search tool. **If I plan to run multiple searches, what are the rate limits for calling `search_listings`?** The API enforces standard rate limiting. For high-volume tasks or batch processing, implement a slight delay between calls, or check our documentation for specific guidelines on bulk requests. **What happens if the `search_listings` tool fails because of bad input parameters?** The agent receives clear error codes and messages detailing the invalid input. These errors specify unsupported criteria, like a property type or an invalid date range, so you can adjust your prompt. **Does `search_listings` only pull data from major city centers, or does it cover rural areas too?** The tool covers listings across multiple urban and regional zones. You should use specific geographic coordinates in the search to target any area, no matter how remote. **How does `search_listings` prioritize keyword filters when I combine them with price ranges?** The tool processes all constraints simultaneously. It first applies your geo-location and then cross-references keywords and budget, returning results that meet every single criterion.