xome_search
Pack: xome · Endpoint: https://gateway.pipeworx.io/xome/mcp
Browse US residential foreclosure/bank-owned (REO)/short-sale auction listings on xome.com by state (and optional county). Returns property facts (beds/baths/sqft/year built/lot size/occupancy), sale type and auction_status/bid_deadline for every listing on the page — NOT the bid or sale price (call xome_property_detail for that plus the exact sale date and courthouse venue). Sourced from xome.com/auctions/{state}[/{county}].
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
state | string | yes | Two-letter US state code, e.g. “ca”, “tx”, “fl” |
county | string | no | Optional county name, e.g. “fresno” or “los angeles” (spaces become dashes automatically) |
page | number | no | Result page, starting at 1 (each page holds ~50-100 listings) |
Example call
Arguments
{
"state": "ca",
"county": "fresno"
}
curl
curl -X POST https://gateway.pipeworx.io/xome/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"xome_search","arguments":{"state":"ca","county":"fresno"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('xome_search', {
"state": "ca",
"county": "fresno"
});
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"xome": {
"url": "https://gateway.pipeworx.io/xome/mcp"
}
}
}
See Getting Started for client-specific install steps.