Usage

​

Get started

1. Add the remote MCP server URL in your AI client. See Install for client-specific steps.
2. Sign in and complete the brightplace consent flow before calling tools.
3. Ask the client to use brightplace Connect for an apartment search.
4. Review listing details, tour slots, and any tour request before acting on them.

​

Typical flow

1. search_apartment_listings — find listings matching objective criteria.
2. get_apartment_listing — read full detail, including brightplace grades, for a result.
3. get_city_transport_and_amenities_guide / get_rental_budget_guide — add neighborhood context and affordability detail for a listing.
4. get_listing_tour_availability — check open tour slots.
5. submit_tour_request — submit a tour request for a chosen slot.

​

Example workflow

1. Search. The renter asks:
   Use brightplace Connect to search for one-bedroom apartments in Brooklyn under $4,500 that are pet friendly and near the subway.
   
   The client calls search_apartment_listings and returns a list of matches.
2. Inspect a result. The renter asks to see one of them:
   Show me the full details for the second result.
   
   The client calls get_apartment_listing with that listing_id, including its brightplace grades.
3. Add context. The renter wants more than the snapshot:
   What's the neighborhood like, and is the rent affordable on a $120k salary?
   
   The client calls get_city_transport_and_amenities_guide and get_rental_budget_guide for the listing.
4. Find a tour. The renter asks:
   Are any tours available this weekend?
   
   The client calls get_listing_tour_availability and lists open slots.
5. Book it. The renter picks a slot:
   Book the Saturday 11am tour. My name is Jordan Lee, jordan@example.com.
   
   The client calls submit_tour_request. Confirm the renter name, email, phone, listing, and slot before allowing this write.

​

Tool results

{
  "ok": true,
  "data": {},
  "latency_ms": 42
}

{
  "ok": false,
  "error": {
    "error_code": "VALIDATION_ERROR",
    "message": "Tool input failed validation.",
    "details": {}
  },
  "latency_ms": 2
}