API Reference

Complete reference for all 8 PropertyMCP tools. Each tool is callable through the MCP protocol.

property_search

Search for property listings by address, zip code, or MLS number.

Parameters

NameTypeRequiredDescription
querystringRequiredAddress, zip code, or MLS number
filters.minPricenumberOptionalMinimum price in USD
filters.maxPricenumberOptionalMaximum price in USD
filters.minBedsnumberOptionalMinimum bedrooms
filters.maxBedsnumberOptionalMaximum bedrooms
filters.minBathsnumberOptionalMinimum bathrooms
filters.propertyTypestringOptionalsingle_family, condo, townhouse, land, multi_family, any
Output: Array of properties with address, price, beds, baths, sqFt, yearBuilt, listingUrl, features
Data Source: Zillow API
Cache TTL: 24 hours

neighborhood_data

Get demographic and neighborhood data for a zip code.

Parameters

NameTypeRequiredDescription
zipCodestringRequired5-digit US zip code
Output: Demographics (population, median age), economics (income, poverty rate), housing (home values, rent), education, commute data
Data Source: U.S. Census Bureau (ACS 5-Year)
Cache TTL: 14 days

school_ratings

Get school ratings and data for a zip code.

Parameters

NameTypeRequiredDescription
zipCodestringRequired5-digit US zip code
Output: Array of schools with name, type, rating (1-10), grades, enrollment, student-teacher ratio, test scores
Data Source: GreatSchools API
Cache TTL: 30 days

walk_score

Get walkability, transit, and bike scores for an address.

Parameters

NameTypeRequiredDescription
addressstringRequiredFull street address
latnumberOptionalLatitude (improves accuracy)
lonnumberOptionalLongitude (improves accuracy)
Output: Walk Score (0-100), Transit Score, Bike Score, walkability breakdown by category
Data Source: Walk Score API
Cache TTL: 7 days

mortgage_calculator

Calculate monthly mortgage payments with full amortization breakdown.

Parameters

NameTypeRequiredDescription
principalnumberRequiredHome purchase price in USD
ratenumberRequiredAnnual interest rate (e.g., 7.5)
termYearsnumberRequiredLoan term in years (15 or 30)
downPaymentPercentnumberRequiredDown payment percentage
propertyTaxRatenumberOptionalAnnual property tax rate %
annualInsurancenumberOptionalAnnual insurance in USD
monthlyHOAnumberOptionalMonthly HOA fees in USD
Output: Monthly payment breakdown (P&I, tax, insurance, HOA, PMI), totals, 12-month amortization table
Data Source: Pure calculation (no external API)
Cache TTL: None

listing_description_generator

Generate MLS-ready listing descriptions from property details.

Parameters

NameTypeRequiredDescription
addressstringRequiredProperty address
bedsnumberRequiredNumber of bedrooms
bathsnumberRequiredNumber of bathrooms
sqFtnumberRequiredSquare footage
yearBuiltnumberRequiredYear built
featuresstring[]OptionalList of property features
stylestringOptionalformal, casual, or luxury
lengthstringOptionalshort (~100 words), medium (~300), long (~500)
Output: MLS-ready listing description in requested style and length
Data Source: Claude API (AI-generated)
Cache TTL: None

comp_analyzer

Analyze comparable sales for a property.

Parameters

NameTypeRequiredDescription
addressstringRequiredSubject property address
radiusMilesnumberOptionalSearch radius in miles (default: 1)
daysBacknumberOptionalDays back to search (default: 90)
Output: Recent sales with prices, avg price/sqft, list-to-sale ratio, DOM trends, market insight
Data Source: Zillow API
Cache TTL: 3 days

market_trends

Get real estate market trends for a zip code.

Parameters

NameTypeRequiredDescription
zipCodestringRequired5-digit US zip code
timeRangenumberOptional30, 90, or 180 days (default: 90)
Output: Avg listing price, median sale price, new listings, price trend %, inventory days, market health assessment
Data Source: Zillow API aggregates
Cache TTL: 7 days