Skip to content
MCP tools
Read-onlyListingsMCP tool

listings_list

Search for property listings by address, MLS number, status, or price range.

Last updated

Search for property listings by address, MLS number, status, or price range. Returns pagination info (total_count, has_more, offset, limit) for batch operations. Results include: id, property_address, city, state, zip_code, list_price, listing_status, property_type, bedrooms, bathrooms, square_feet, created_at. Filter by status to find active listings vs sold/expired. Use min_price/max_price to match buyer budgets. For a specific listing by ID, use listings_get instead. For aggregate stats, use listings_stats. Default limit is 20 when not provided; if the default is used and more results exist, the response includes truncated: true and total: N so you can rerun with a higher limit.

Parameters#

ParameterTypeRequiredDescription
querystringNoSearch term — matches against property_address, city, and mls_number (case-insensitive partial match).
statusenumNoFilter by listing status. active=on market, pending=under contract, sold=closed, expired=listing ended, coming_soon=pre-market (default: all). · One of: all, active, pending, sold, expired, cancelled, coming_soon
min_pricenumberNoMinimum listing price in dollars. Use with max_price for buyer matching. · Min: 0
max_pricenumberNoMaximum listing price in dollars. Use with min_price for buyer matching. · Min: 0
property_typeenumNoFilter by property type. · One of: single_family, condo, townhouse, multi_family, land, commercial
limitnumberNoMaximum results (default: 20, max: 500). When omitted and more results exist, response includes truncated: true + total: N. · Max: 500 · Min: 1
offsetnumberNoSkip N results for pagination (default: 0). · Min: 0

Example prompts#

  • "Find active single family listings between 400k and 550k for the Garcias."
  • "Search my listings for anything on Birchwood Ln in Bakersfield."

Safety#

Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.

Previous name#

This tool was previously published as search_listings. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.