search_rental_listings
Pack: rentcast · Endpoint: https://gateway.pipeworx.io/rentcast/mcp
Search ACTIVE rental listings — individual homes and apartments currently for rent in the US, from RentCast’s listing feed. Filter by city+state, ZIP code, or a latitude/longitude radius, plus bedrooms, bathrooms, and property type. Returns each listing’s address, monthly rent, beds/baths, square footage, and listing date. Note: bedrooms/bathrooms filters are exact-match (e.g. bedrooms 3 returns only 3-bed homes; for “3-4 beds” call twice). This is the tool for “find homes/apartments for rent near X” — unlike area rent statistics (HUD Fair Market Rents) or single-address rent estimates.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
_apiKey | string | yes | Rentcast API key |
city | string | no | City name (use with state), e.g. “Waco” |
state | string | no | Two-letter state code, e.g. “TX” |
zip_code | string | no | 5-digit ZIP code (alternative to city/state) |
latitude | number | no | Latitude for radius search (use with longitude and radius_miles) |
longitude | number | no | Longitude for radius search |
radius_miles | number | no | Search radius in miles around latitude/longitude (max 100) |
bedrooms | number | no | Exact number of bedrooms (RentCast matches exactly, not minimum) |
bathrooms | number | no | Exact number of bathrooms (supports halves, e.g. 2.5) |
property_type | string | no | One of: “Single Family”, “Condo”, “Townhouse”, “Manufactured”, “Multi-Family”, “Apartment”, “Land” |
status | string | no | ”Active” (default) or “Inactive” |
max_results | number | no | Max listings to return (default 20, max 100) |
Example call
Arguments
{
"_apiKey": "your-rentcast-api-key",
"city": "Waco",
"state": "TX",
"bedrooms": 3,
"bathrooms": 2,
"property_type": "Single Family",
"status": "Active"
}
curl
curl -X POST https://gateway.pipeworx.io/rentcast/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_rental_listings","arguments":{"_apiKey":"your-rentcast-api-key","city":"Waco","state":"TX","bedrooms":3,"bathrooms":2,"property_type":"Single Family","status":"Active"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('search_rental_listings', {
"_apiKey": "your-rentcast-api-key",
"city": "Waco",
"state": "TX",
"bedrooms": 3,
"bathrooms": 2,
"property_type": "Single Family",
"status": "Active"
});
More examples
{
"_apiKey": "your-rentcast-api-key",
"zip_code": "76667",
"max_results": 50
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"rentcast": {
"url": "https://gateway.pipeworx.io/rentcast/mcp"
}
}
}
See Getting Started for client-specific install steps.