# SimplyRETS MCP > SimplyRETS connects your AI agent directly to live MLS real estate data. It lets you search for listings by location or price using `list_properties`, pull deep details on specific properties with `get_property`, and analyze market trends using property analytics tools. Stop clicking through separate database portals; query all this structured, current real estate information in natural language. ## Overview - **Category:** real-estate - **Price:** Free - **Tags:** mls-data, real-estate-api, property-search, agent-listings, market-analysis ## Description SimplyRETS connects your AI agent directly to live MLS data. You don't gotta click through a dozen separate database portals anymore. You just talk to the system and tell it what you need; your agent handles pulling all that structured, current real estate intel for ya. **Searching and Filtering Listings** You can use `list_properties` to search or filter listings by criteria like location, price range, or MLS identifiers. This tool lets you instantly pull a list of properties that match your exact needs, whether you're scouting an area or tracking down specific IDs across the feed. **Getting Full Property Details** Need every damn detail on one house? Running `get_property` pulls comprehensive data for any single listing ID. This isn't just a basic description; it gives you all the metadata, features, and even school district information tied to that specific property. **Analyzing Market Performance** Don't just look at houses—you gotta understand what the market's doing. You can run `get_property_analytics` to generate performance metrics and comparative data for a set of properties or an entire area, giving you actionable insights. Before running those big reports, you might need context; `get_property_metadata` retrieves the structural data—like available city codes or supported property status types—so your queries are always accurate. **Checking Schedules and Agents** You'll never miss a viewing because using `list_open_houses` pulls all scheduled open house events, complete with dates and times across the entire MLS feed. If you need to talk to someone about it, you can use `list_agents` to pull contact information and detailed profiles for every real estate agent tied to the listings. **How It Works** Your AI client handles all the heavy lifting. Instead of manually cross-referencing data sources, your agent first checks the available market context using tools like `get_property_metadata`, which tells you exactly what kind of cities or property types are supported in the feed. You can then narrow down your search with `list_properties` based on location, price range, or MLS ID to get a filtered list of matches. For deep research, if you pinpoint a specific listing, running `get_property` gives you everything—the features, the school data, the full rundown. If you're looking at trends across an area, generating market reports is easy with `get_property_analytics`, which calculates performance metrics and comparative analytics for that region. You can check upcoming showings by pulling all open house events via `list_open_houses` or get direct contact info for agents through `list_agents`. Every tool works together to pull the complete picture of the current real estate landscape. ## Tools ### list_agents Lists contact and profile information for real estate agents tied to the MLS feed. ### get_property Fetches complete details, including features and school data, for one specific property listing ID. ### list_open_houses Retrieves a list of scheduled open house events, including dates and times, from the local listings. ### list_properties Searches or filters property listings based on criteria like location, price range, or MLS identifiers. ### get_property_analytics Generates performance metrics and comparative analytics for a set of properties or an area. ### get_property_metadata Retrieves the structural data context, such as available city codes or property status types, within the feed. ## Prompt Examples **Prompt:** ``` Search for active property listings in Houston with a limit of 5. ``` **Response:** ``` I found 5 active listings in Houston. One notable property is at 12402 Dakar (MLS: 123456) listed for $450,000. Would you like more details on any of these? ``` **Prompt:** ``` Show me all upcoming open houses from the MLS feed. ``` **Response:** ``` Retrieving open house data... I found 3 upcoming events. The next one is scheduled for 742 Evergreen Terrace this Sunday from 1 PM to 4 PM. ``` **Prompt:** ``` Get analytics for property MLS ID 123456. ``` **Response:** ``` Fetching analytics for MLS 123456... This property has seen a 5% increase in viewings this week and is priced 2% below the neighborhood average. ``` ## Capabilities ### Search and Filter Listings Lists multiple properties that match criteria like location, price, or MLS identifiers. ### Get Full Property Details Retrieves all available metadata, features, and school district information for a single listing ID. ### Generate Market Performance Reports Calculates and returns data-driven insights and performance metrics based on property listings in a specified area. ### Check Open House Schedules Lists all upcoming open house events, including dates and times across the MLS feed. ### Access Agent Contacts Pulls contact information and details for real estate agents associated with listings. ### Check Market Data Context Retrieves the available data context, such as supported cities or property types, to guide your queries. ## Use Cases ### Client Needs Full Property History A client loves a house but needs to know its history. Instead of calling the agent or checking three different websites, you ask your agent: 'What are the school ratings and full details for MLS ID 123456?' The agent runs `get_property` and gets all the structured data in one go. ### Finding Availability for a Weekend Trip You're organizing a showing tour. Instead of calling three different agents to check their calendars, you ask: 'Show me all open houses near downtown this weekend.' The agent runs `list_open_houses` and gives you a consolidated schedule. ### Researching Market Trends in a Neighborhood A client wants to buy in a new area but isn't sure if it’s stable. You ask the agent to run `get_property_analytics` on that neighborhood. The tool returns data showing viewings trends and average price changes, helping you advise confidently. ### Filtering Out Unwanted Listings You need 10 listings in a specific zip code but only want ones priced under $650k. You tell your agent to run `list_properties` with the precise parameters, skipping all the manual filtering steps and getting a clean list of relevant options. ## Benefits - Find listings faster. Instead of browsing through dozens of search tabs, use `list_properties` to filter properties by exact parameters—like a specific price range or zip code—and get immediate results in your chat window. - Deep dive into single listings. When you find a promising property, don't waste time opening multiple browser tabs. `get_property` pulls every detail, including school district ratings and unique features, immediately. - Know the local market metrics. The `get_property_analytics` tool lets you move beyond listing prices to understand viewings trends and neighborhood performance—essential for advising a client. - Manage contacts easily. Never manually search for an agent's number again. Use `list_agents` to pull up professional contact information directly from the MLS feed when needed. - Stay updated on showings. Need to know which properties are open this weekend? `list_open_houses` gives you a clean list of dates and times across your target area. ## How It Works The bottom line is that your AI client acts as the direct query layer between your natural language questions and the structured real estate database. 1. Subscribe to this server on Vinkius and input your SimplyRETS API Key and Secret. 2. Instruct your AI client to perform a task (e.g., 'Find all listings over $800k in Austin'). 3. The agent runs the necessary tools (`list_properties`, `get_property`), pulls the live MLS data, and provides you with a formatted answer. ## Frequently Asked Questions **How do I use list_properties to search for a price range?** You specify the criteria directly when asking your agent. You tell it, 'Use `list_properties` to find all listings between $500k and $750k.' The tool handles the filtering logic for you. **What is the difference between list_open_houses and list_properties?** They serve different purposes. `list_properties` gives a general search of available homes based on criteria. `list_open_houses` specifically pulls only scheduled open house events for that area. **Do I need to know the MLS ID to get_property details?** Yes, you must provide the specific listing identifier (the MLS ID) when running `get_property`. The tool needs a unique reference point to pull the full data set. **Can I use list_agents if I don't have a property ID?** Yes, you can. You simply ask your agent to run `list_agents` when you need contact information or profiles for agents in a specific geographical area. **How do I authenticate my AI client when using list_properties?** You must provide your SimplyRETS API Key and Secret during server setup. The system validates these credentials before it runs any search, ensuring secure access to the live MLS data. **What should I do if my call to get_property_analytics fails due to rate limiting?** Wait 60 seconds and try the query again. The server responds with a specific HTTP 429 error code when limits are hit, letting your AI client know exactly what's wrong. **How do I check all possible property statuses using get_property_metadata?** The tool returns a structured list of valid status codes, including 'Active', 'Pending', and 'Sold'. You can use this data to refine your search criteria perfectly. **Does list_agents provide contact details for non-MLS affiliated agents?** No. The agent list is strictly limited to MLS registered professionals and their associated official listing data. The feed only contains verified, authorized information. **Can I search for properties in a specific city or area?** Yes. Use the `list_properties` tool with the `q` parameter to search for specific locations, or use `points` for a geospatial polygon search. **How do I get the full details of a listing if I have the MLS ID?** Simply provide the MLS ID to the `get_property` tool. It will return comprehensive metadata including price, features, and property history. **Can I see which agents are listed in the feed?** Yes, the `list_agents` tool retrieves agent information directly from the MLS feed, allowing you to see contact details and affiliations.