# Tell us what you need.

Tell cf0 where you work or study. cf0 emails you when a home that fits is listed.

## For agents

1. Send POST https://cf0.ai/api/public/home-requests with JSON { email, work: null, work_text: "<street or office address>", walk_minutes: 10 | 20 | 30 | 40, beds_min, rent_max, currency, move_by: "YYYY-MM", employer, src, door: "api", consent: true }.
2. The answer is 202 { status: "check_email" }. The renter confirms the request from the email.
3. See homes that fit now with GET https://cf0.ai/api/public/home-requests/fit?lat=&lng=&walk=&beds=&rent_max=&currency=.
4. An MCP client can call the tool request_home on https://cf0.ai/mcp/public with { email, near, walk_minutes, beds, rent_max, move_by, company }. No sign-in is necessary. The tool search_homes finds homes near a place.