{"openapi":"3.1.0","info":{"title":"Repliers (BYOK) API","version":"0.1.0","description":"Repliers (BYOK) lets an AI assistant read your own Repliers data through the Repliers API with a key you supply (Repliers API key). Read-only: 6 tools (search_listings, get_similar_listings, autocomplete_locations, search_locations, list_offices, list_members). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-repliers.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-repliers/docs"},"termsOfService":"https://connectorbay.com/byok-repliers/terms"},"servers":[{"url":"https://byok-repliers.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-repliers/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_listings":{"post":{"operationId":"search_listings","summary":"Search MLS listings with filters; returns price, status, type, dates, address, bedrooms, bathrooms, size and brokerage. ","description":"Search MLS listings with filters; returns price, status, type, dates, address, bedrooms, bathrooms, size and brokerage. This is a read-only search (a POST that sends no body). Use for \"Find active houses for sale in Milton, Ontario under 900000\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"city":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"City name (one value), for example 'Milton'.","title":"City"},"state":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"State or province, for example 'ON' or 'NY' (one value).","title":"State"},"neighborhood":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"Neighborhood name (one value).","title":"Neighborhood"},"zip":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"Postal or ZIP code.","title":"Zip"},"status":{"anyOf":[{"enum":["A","U"],"type":"string"},{"type":"null"}],"default":null,"description":"Listing status: A (active) or U (unavailable); the API default is active.","title":"Status"},"type":{"anyOf":[{"enum":["sale","lease"],"type":"string"},{"type":"null"}],"default":null,"description":"sale or lease; all types are returned when omitted.","title":"Type"},"listing_class":{"anyOf":[{"enum":["condo","residential","commercial"],"type":"string"},{"type":"null"}],"default":null,"description":"Class of listing.","title":"Listing Class"},"min_price":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum list price.","title":"Min Price"},"max_price":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum list price.","title":"Max Price"},"min_bedrooms":{"anyOf":[{"maximum":50,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum bedrooms.","title":"Min Bedrooms"},"min_baths":{"anyOf":[{"maximum":50,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum total bathrooms.","title":"Min Baths"},"search":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Full-text keyword search.","title":"Search"},"sort_by":{"anyOf":[{"enum":["updatedOnDesc","updatedOnAsc","createdOnDesc","createdOnAsc","listPriceAsc","listPriceDesc","bedsAsc","bedsDesc","sqftAsc","sqftDesc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort order, for example updatedOnDesc (default), listPriceAsc, listPriceDesc, createdOnDesc, bedsDesc.","title":"Sort By"},"page_num":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Num"},"results_per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page.","title":"Results Per Page"}},"title":"search_listingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_similar_listings":{"post":{"operationId":"get_similar_listings","summary":"Find listings similar to a given MLS number, with distance, price-change type and estimate when available. Use for \"Show","description":"Find listings similar to a given MLS number, with distance, price-change type and estimate when available. Use for \"Show listings similar to W10440893\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"mls_number":{"description":"MLS number of the listing, for example 'W10440893'.","maxLength":200,"title":"Mls Number","type":"string"},"radius":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only listings within this radius (in radius_unit).","title":"Radius"},"radius_unit":{"anyOf":[{"enum":["m","km","mi","yd"],"type":"string"},{"type":"null"}],"default":null,"description":"Unit of the radius: m, km, mi or yd.","title":"Radius Unit"},"list_price_range":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only listings whose list price is within plus or minus this amount of the listing's price.","title":"List Price Range"}},"required":["mls_number"],"title":"get_similar_listingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/autocomplete_locations":{"post":{"operationId":"autocomplete_locations","summary":"Suggest locations (cities, neighborhoods, areas) matching typed text; returns location ids, names, types and coordinates","description":"Suggest locations (cities, neighborhoods, areas) matching typed text; returns location ids, names, types and coordinates. Use for \"Which locations match 'milt'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"description":"Text typed so far, for example 'milt'.","maxLength":100,"title":"Search","type":"string"},"state":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Limit to this 2-letter state or province code.","title":"State"},"city":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"Limit to this city name.","title":"City"},"results_per_page":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Results to return.","title":"Results Per Page"}},"required":["search"],"title":"autocomplete_locationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_locations":{"post":{"operationId":"search_locations","summary":"List locations (areas, cities, neighborhoods) filtered by state, city or name, with type, source and coordinates. Use fo","description":"List locations (areas, cities, neighborhoods) filtered by state, city or name, with type, source and coordinates. Use for \"List the neighborhoods of Milton\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"state":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"2-letter state or province code (one value).","title":"State"},"city":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"City name (one value).","title":"City"},"type":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Location type, for example area, city or neighborhood (one value).","title":"Type"},"name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Exact location name (one value).","title":"Name"},"page_num":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Num"},"results_per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page.","title":"Results Per Page"}},"title":"search_locationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_offices":{"post":{"operationId":"list_offices","summary":"List MLS brokerage offices with name, office id, address, phone and website. Use for \"Find brokerage offices named 'Roya","description":"List MLS brokerage offices with name, office id, address, phone and website. Use for \"Find brokerage offices named 'Royal'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keywords":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text to filter offices by.","title":"Keywords"},"office_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Exact office id.","title":"Office Id"},"board_id":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"MLS board id; required only if the key can access several boards.","title":"Board Id"},"page_num":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Num"},"results_per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page.","title":"Results Per Page"}},"title":"list_officesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_members":{"post":{"operationId":"list_members","summary":"List MLS members (agents) with name, agent id, position, status, brokerage name and website; email addresses are not ret","description":"List MLS members (agents) with name, agent id, position, status, brokerage name and website; email addresses are not returned. Use for \"Find agents named 'Smith'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keywords":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text to search members by (up to 100 characters).","title":"Keywords"},"agent_name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Exact agent name.","title":"Agent Name"},"agent_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Exact agent id.","title":"Agent Id"},"brokerage":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Brokerage name (partial match, one value).","title":"Brokerage"},"board_id":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"MLS board id; required only if the key can access several boards.","title":"Board Id"},"page_num":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page Num"},"results_per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page.","title":"Results Per Page"}},"title":"list_membersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}