Skip to Content

Read API

A set of read-only tools to query your brokerage’s data — available over MCP (Model Context Protocol) and for integrations. Authenticate with your Supabase access token (Authorization: Bearer <token>); results are scoped to your brokerage by RLS.

search_listings

Search the Onoots real-estate catalog (active listings).

ParameterTypeDescription
citystringFilter by city (partial match)
maxPricenumberMaximum price
limitnumberMax results (1–50, default 10)

Returns price, location, and basic features.

list_leads

List the brokerage’s most recent leads (CRM contacts).

ParameterTypeDescription
limitnumberMax results (1–50, default 10)

Returns name, contact, source, and date.

get_lead

Get a single lead’s full details by its id.

ParameterTypeRequiredDescription
leadIdstring (uuid)The lead UUID

Returns name, contact, message, source, and claim state.

list_deals

List recent deals in the pipeline.

ParameterTypeDescription
limitnumberMax results (1–50, default 10)

Returns stage, sale price, commission, and compliance state.

brokerage_summary

Quick activity counts for your brokerage: total leads, new leads in the last 7 days, and total deals. No parameters.

These tools are read-only. To create or update records, use the REST endpoints: Leads, Listings, Deals.

Last updated on