API Reference

Investra exposes 13 tools through the Model Context Protocol. Each tool is called by your AI assistant automatically when it determines the tool is relevant to your prompt. You do not need to call these tools directly — simply ask your question in natural language and the assistant will select the appropriate tool.

Below you will find the tool name, description, parameter table, an example prompt, and a representative response structure for each tool.

Search on-market property listings by location, price range, bedrooms, bathrooms, and property type. Returns a list of matching properties with key details.

Parameter	Type	Required	Description
location	string	Yes	City and state, or zip code (e.g. "Tampa, FL" or "33601").
minPrice	number	No	Minimum listing price in USD.
maxPrice	number	No	Maximum listing price in USD.
beds	number	No	Minimum number of bedrooms.
baths	number	No	Minimum number of bathrooms.
propertyType	string	No	One of house, condo, townhouse, or multifamily.
limit	number	No	Number of results to return. Default 10, max 40.

Example prompt:

Find 3-bedroom houses in Orlando, FL between $250k and $400k

Example response structure:

{
  "properties": [
    {
      "address": "123 Oak Lane, Orlando, FL 32801",
      "price": 349000,
      "beds": 3,
      "baths": 2,
      "sqft": 1650,
      "propertyType": "house",
      "yearBuilt": 2004,
      "daysOnMarket": 12,
      "listingUrl": "https://..."
    }
  ],
  "total": 87,
  "returned": 10
}

Retrieve detailed information for a specific property by its full street address, including valuation, tax history, and property characteristics.

Parameter	Type	Required	Description
address	string	Yes	Full property address including city, state, and zip.

Example prompt:

Get details for 456 Elm Street, Austin, TX 78701

Example response structure:

{
  "address": "456 Elm Street, Austin, TX 78701",
  "price": 525000,
  "beds": 4,
  "baths": 3,
  "sqft": 2200,
  "lotSize": 0.18,
  "yearBuilt": 1998,
  "propertyType": "house",
  "taxAssessment": 485000,
  "annualTax": 9200,
  "zestimate": 530000,
  "description": "...",
  "features": ["Central AC", "Hardwood floors", "Garage"]
}

Get a comprehensive market analysis for a given city, including median prices, days on market, inventory levels, price trends, and an overall market summary.

Parameter	Type	Required	Description
city	string	Yes	City name (e.g. "Jacksonville").
state	string	Yes	Two-letter state code (e.g. "FL").

Example prompt:

Analyze the real estate market in Jacksonville, FL

Example response structure:

{
  "city": "Jacksonville",
  "state": "FL",
  "medianPrice": 310000,
  "medianPriceChange": 5.2,
  "avgDaysOnMarket": 28,
  "activeListings": 4350,
  "medianPricePerSqft": 185,
  "marketTemperature": "warm",
  "summary": "Jacksonville continues to see steady appreciation..."
}

Retrieve national or categorical market data. Use the optional category parameter to drill into a specific data segment.

Parameter	Type	Required	Description
category	string	No	One of rates, prices, supply, demand, economy, or rental. Omit for a broad overview.

Example prompt:

Show me the latest rental market data

Example response structure:

{
  "category": "rental",
  "data": {
    "nationalMedianRent": 1850,
    "yearOverYearChange": 3.1,
    "vacancyRate": 6.2,
    "topMarkets": [
      { "city": "Miami", "medianRent": 2400, "change": 4.5 },
      { "city": "Austin", "medianRent": 1950, "change": -1.2 }
    ]
  },
  "asOf": "2026-04-01"
}

Pull recent comparable sales for a given property address. Optionally provide property characteristics to improve matching accuracy.

Parameter	Type	Required	Description
address	string	Yes	Full property address.
beds	number	No	Number of bedrooms in the subject property.
baths	number	No	Number of bathrooms in the subject property.
sqft	number	No	Square footage of the subject property.
currentPrice	number	No	Current listing or estimated price for comparison.

Example prompt:

Get sales comps for 789 Pine Ave, Denver, CO 80202 — it's a 3-bed, 2-bath, 1400 sqft

Example response structure:

{
  "subject": "789 Pine Ave, Denver, CO 80202",
  "comps": [
    {
      "address": "801 Pine Ave, Denver, CO 80202",
      "salePrice": 415000,
      "saleDate": "2026-02-14",
      "beds": 3,
      "baths": 2,
      "sqft": 1380,
      "distance": 0.1
    }
  ],
  "medianCompPrice": 420000,
  "avgPricePerSqft": 298
}

Estimate monthly rent for a property based on its address and characteristics. Returns a rent range and comparable rental data.

Parameter	Type	Required	Description
address	string	Yes	Full property address.
beds	number	No	Number of bedrooms.
baths	number	No	Number of bathrooms.
sqft	number	No	Square footage.

Example prompt:

What would 123 Main St, Tampa, FL 33601 rent for? It's a 3/2 with 1500 sqft.

Example response structure:

{
  "address": "123 Main St, Tampa, FL 33601",
  "rentEstimate": 1950,
  "rentRangeLow": 1750,
  "rentRangeHigh": 2150,
  "comparables": [
    {
      "address": "130 Main St, Tampa, FL 33601",
      "rent": 1900,
      "beds": 3,
      "baths": 2,
      "sqft": 1475
    }
  ]
}

Estimate ownership and acquisition costs for a property, including taxes, insurance, maintenance, closing costs, and rehab budgets. Use the type parameter to get a specific cost category or full for everything.

Parameter	Type	Required	Description
address	string	Yes	Full property address.
price	number	Yes	Purchase price in USD.
type	string	No	Cost category: full (default), taxes, insurance, maintenance, closing, or rehab.
downPaymentPct	number	No	Down payment percentage. Default 20.
rehabScope	string	No	Rehab scope: light, moderate, or heavy. Only used when type is full or rehab.

Example prompt:

Estimate all costs for 321 Cedar Blvd, Nashville, TN 37201 at $375k with 25% down and a moderate rehab

Example response structure:

{
  "address": "321 Cedar Blvd, Nashville, TN 37201",
  "price": 375000,
  "downPayment": 93750,
  "loanAmount": 281250,
  "monthlyMortgage": 1875,
  "annualTaxes": 4200,
  "monthlyInsurance": 145,
  "monthlyMaintenance": 310,
  "closingCosts": 11250,
  "rehabEstimate": 42000,
  "totalMonthlyCost": 2640
}

Returns the current average 30-year fixed mortgage interest rate. No parameters required.

Parameter	Type	Required	Description
No parameters

Example prompt:

What is the current mortgage interest rate?

Example response structure:

{
  "rate": 6.78,
  "type": "30-year fixed",
  "asOf": "2026-04-07",
  "weeklyChange": -0.03
}

Browse curated investment deals with projected ROI. Filter by deal strategy, location, and minimum return.

Parameter	Type	Required	Description
dealType	string	No	One of fix_flip, brrrr, buy_hold, wholesale, or syndication.
city	string	No	Filter by city name.
state	string	No	Filter by two-letter state code.
minRoi	number	No	Minimum projected ROI percentage.
limit	number	No	Number of results. Default 10, max 50.

Example prompt:

Show me BRRRR deals in Ohio with at least 15% ROI

Example response structure:

{
  "deals": [
    {
      "dealId": "a1b2c3d4-...",
      "title": "Duplex BRRRR in Columbus",
      "dealType": "brrrr",
      "city": "Columbus",
      "state": "OH",
      "askingPrice": 185000,
      "arv": 265000,
      "projectedRoi": 22.5,
      "capRate": 8.1,
      "summary": "..."
    }
  ],
  "total": 34,
  "returned": 10
}

Retrieve the full details of a specific deal by its unique deal ID (UUID). Returns financials, photos, description, and contact information.

Parameter	Type	Required	Description
dealId	string (UUID)	Yes	The unique identifier of the deal.

Example prompt:

Get the full details for deal a1b2c3d4-e5f6-7890-abcd-ef1234567890

Example response structure:

{
  "dealId": "a1b2c3d4-...",
  "title": "Duplex BRRRR in Columbus",
  "dealType": "brrrr",
  "address": "456 Broad St, Columbus, OH 43215",
  "askingPrice": 185000,
  "arv": 265000,
  "rehabCost": 35000,
  "projectedRoi": 22.5,
  "capRate": 8.1,
  "cashFlow": 680,
  "description": "...",
  "photos": ["https://..."],
  "postedBy": "InvestorJane",
  "postedAt": "2026-03-28T14:00:00Z"
}

Search Investra's database of 40M+ off-market properties. These are properties not currently listed on the MLS, offering opportunities for direct-to-seller outreach.

Parameter	Type	Required	Description
city	string	Yes	City name.
state	string	Yes	Two-letter state code.
zip	string	No	ZIP code to narrow results.
minPrice	number	No	Minimum estimated value.
maxPrice	number	No	Maximum estimated value.
limit	number	No	Number of results. Default 20, max 200.

Example prompt:

Find off-market properties in Atlanta, GA under $200k

Example response structure:

{
  "properties": [
    {
      "street": "789 Peach St",
      "city": "Atlanta",
      "state": "GA",
      "zip": "30301",
      "estimatedValue": 175000,
      "beds": 3,
      "baths": 1,
      "sqft": 1200,
      "yearBuilt": 1965,
      "ownerType": "individual",
      "investmentScore": 72
    }
  ],
  "total": 1240,
  "returned": 20
}

Retrieve detailed information for a specific off-market property, including investment metrics, tax history, and ownership data. Each call uses 1 credit from your plan.

Parameter	Type	Required	Description
street	string	Yes	Street address (e.g. "789 Peach St").
city	string	Yes	City name.
state	string	Yes	Two-letter state code.
zip	string	Yes	ZIP code.

Example prompt:

Get details for 789 Peach St, Atlanta, GA 30301

Example response structure:

{
  "street": "789 Peach St",
  "city": "Atlanta",
  "state": "GA",
  "zip": "30301",
  "estimatedValue": 175000,
  "beds": 3,
  "baths": 1,
  "sqft": 1200,
  "lotSize": 0.15,
  "yearBuilt": 1965,
  "ownerName": "John Doe",
  "ownerType": "individual",
  "investmentScore": 72,
  "rentalEstimate": 1350,
  "capRateEstimate": 7.8,
  "cashFlowMonthly": 420,
  "marketTrend": "appreciating",
  "riskRating": "medium",
  "neighborhoodScore": 65,
  "taxAssessment": 162000,
  "annualTax": 3100
}

Look up owner contact information for a property, including phone numbers and email addresses. Designed for direct-to-seller outreach on off-market properties. Each call uses 1 lead credit.

Parameter	Type	Required	Description
street	string	Yes	Street address.
city	string	Yes	City name.
state	string	Yes	Two-letter state code.
zip	string	Yes	ZIP code.

Example prompt:

Skip trace the owner of 789 Peach St, Atlanta, GA 30301

Example response structure:

{
  "street": "789 Peach St",
  "city": "Atlanta",
  "state": "GA",
  "zip": "30301",
  "ownerName": "John Doe",
  "phones": [
    { "number": "+14045551234", "type": "mobile", "carrier": "Verizon" }
  ],
  "emails": [
    { "address": "johndoe@email.com", "type": "personal" }
  ],
  "mailingAddress": "100 Other St, Atlanta, GA 30302",
  "creditsRemaining": 47
}