# Cubi Estate Agent API

**Canonical:** https://apis.io/apis/cubi-estate/cubi-estate-agent-api/  
**Provider:** Cubi Estate — https://apis.io/providers/cubi-estate/  
**Base URL:** https://mcp.cubi.estate  
**Documentation:** https://www.cubi.estate/cubi-api

Cubi Estate Agent API is one of 42 APIs that [Cubi Estate](https://apis.io/providers/cubi-estate/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 5 JSON Schema definitions. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 5 JSON Schemas.

The Agent API from Cubi Estate — 98 operation(s) for agent.

## Operations (60 of 102)

| Method | Path | Summary |
|---|---|---|
| POST | `/agent/search` | Property search returning rendered markdown for LLM agents (e.g. |
| POST | `/agent/carousel` | Deliver a different listing from a recent /agent/search to the user's chat… |
| POST | `/agent/actions-menu` | WA-only: send the `⋯ More` follow-up list message… |
| POST | `/agent/pick` | Pick ONE listing from the chat's most-recent carousel by an objective criterion… |
| POST | `/agent/reset` | Wipe all cached carousels for one chat. Used by the /reset slash command |
| POST | `/agent/join` | Self-service /join: auto-approve the sender onto the allow-list + DM the admin |
| POST | `/agent/mute` | Admin /mute : silence the degraded-search outage alerts for N minutes (0 =… |
| POST | `/agent/near-me` | /near-me: coordinate-ranked listings for a shared GPS pin (lat/lon →… |
| POST | `/agent/near-me/prompt` | /near-me step 1: send the 'share your location' request (Telegram… |
| POST | `/agent/user-consent` | Record the end-user's contact-consent choice (Yes/No) + ack (mig 156) |
| POST | `/agent/consent-menu` | Re-show the contact-consent Yes/No prompt (backs the /consent command) |
| POST | `/agent/bug` | Persist a bug report to the bug_reports queue |
| POST | `/agent/report` | Persist an external listing URL to the listing_reports queue |
| POST | `/agent/report-listing` | Build + deliver a /report page for an existing corpus listing (no fetch) |
| GET | `/agent/price-band/{listing_id}` | Structured asking-price comparison for one corpus listing (MCP… |
| POST | `/agent/inventory` | Share of each place's listings within a budget (MCP compare_inventory) |
| GET | `/agent/price-history/{listing_id}` | Every observed asking-price change for one listing (MCP get_price_history) |
| POST | `/agent/similar-elsewhere` | Homes like one listing in another city, side by side (MCP… |
| POST | `/agent/similar-homes` | Homes like one listing in its own market, by Cubi's similarity model (MCP… |
| POST | `/agent/estimate` | Comp-based fair-value price band for an existing corpus listing |
| POST | `/agent/signal` | Record a per-listing engagement signal (web saves → user_listing_signal) |
| POST | `/agent/listing/view` | Record that a user opened a listing's detail pane (§41 → detail_viewed signal) |
| POST | `/agent/detail-action` | Track a listing-detail deep-dive button tap (§54) → user_command_event; returns… |
| POST | `/agent/turn-feedback` | Record a turn-level 👍/👎 on an assistant reply (web thumbs → turn_feedback, mig… |
| DELETE | `/agent/turn-feedback` | Admin-only cleanup: purge turn_feedback rows for one user (optionally one turn) |
| POST | `/agent/guest/session` | Ensure a guest capability: the same one back while valid, refreshed under 30… |
| POST | `/agent/guest/adopt` | Option B §5a: move a legacy browser-minted guest's data into the server-issued… |
| POST | `/agent/guest/claim` | Move a guest identity's saved searches, favorites, signals and conversations… |
| POST | `/agent/alert/subscribe` | Opt in to be emailed when new listings match a search (mig 342; §42 baseline… |
| POST | `/agent/expansion/subscribe` | Opt in to be emailed IF Cubi expands to a country we don't cover (mig 366, §33d) |
| POST | `/agent/expansion/unsubscribe` | Leave the expansion waitlist for one country (or all) — mig 366, §33d |
| POST | `/agent/brief` | Submit a delegated-search brief (P0 concierge; shortlist by email, fulfilled by… |
| POST | `/agent/brief/withdraw` | Withdraw a brief: erases its email and free text (P0 concierge) |
| POST | `/agent/alert/unsubscribe` | Cancel a search alert (or all of a user's) |
| POST | `/agent/price-drop-email/subscribe` | Opt in to price-drop emails for saved listings (§55) |
| POST | `/agent/price-drop-email/unsubscribe` | Toggle price-drop emails off (§55, Art 7(3) two-way) |
| GET | `/agent/price-drop-email/status` | Price-drop email toggle state for a web user (§55) |
| POST | `/agent/newsletter/subscribe` | In-product opt-in to the Cubi product-update newsletter (double opt-in) |
| GET | `/agent/newsletter/status` | A signed-in user's newsletter opt-in status (drives the FE toggle) |
| POST | `/agent/newsletter/unsubscribe` | Withdraw newsletter consent for a signed-in user (GDPR Art 7(3)) |
| POST | `/agent/save` | Save a listing from a cached carousel into the user's saved list |
| POST | `/agent/unsave` | Remove a listing from the user's saved list |
| POST | `/agent/conversations` | Create a web chat conversation (Claude-style /chat sidebar) |
| GET | `/agent/conversations` | List a web user's chat conversations, newest first |
| POST | `/agent/web-session-event` | Count one proxy-answered session_expired (the FE beacon). Counts only |
| POST | `/agent/conversations/listing` | Create (idempotently) a chat anchored to one listing — the 'Ask Cubi about this… |
| GET | `/agent/listing/{listing_id}/others-asked` | 'What others have asked Cubi about this home' — topics other buyers raised… |
| GET | `/agent/listing/{listing_id}/contact-options` | The 'Ask CUBI about this home' contact-method menu for one listing ({text… |
| POST | `/agent/listing-chat/event` | Record an FE-side action in a listing-anchored chat (test-window tracking) |
| GET | `/agent/credits` | Remaining web-search credits (free search pool) for a web user |
| GET | `/agent/conversation/{conv_id}` | Fetch a web chat conversation transcript |
| PATCH | `/agent/conversation/{conv_id}` | Rename or archive a web chat conversation |
| DELETE | `/agent/conversation/{conv_id}` | Delete a web chat conversation |
| POST | `/agent/conversation/{conv_id}/messages` | Append a completed turn to a web chat conversation |
| POST | `/agent/conversation/{conv_id}/truncate` | Delete a transcript suffix (Stop / Edit-and-re-ask) and fence out in-flight… |
| POST | `/agent/feedback` | Record in-chat feedback (emoji rating + optional note) |
| POST | `/agent/subscribe` | Subscribe a chat to a daily digest for a saved search query |
| POST | `/agent/unsubscribe` | Cancel a daily-digest subscription (or all of a user's) |
| POST | `/agent/subscriptions` | List a chat's active daily-digest subscriptions |
| POST | `/agent/digest/run` | Kick the daily-digest batch (re-run all due subscriptions + deliver) |

…and 42 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/cubi-estate/openapi/cubi-estate-agent-api-openapi.yml
- **Documentation** — https://mcp.cubi.estate/docs
- **JSONSchema** — https://artifacts.apis.io/cubi-estate/json-schema/cubi-estate-agent-filter-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/cubi-estate/json-schema/cubi-estate-agent-search-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/cubi-estate/json-schema/cubi-estate-agent-similar-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/cubi-estate/json-schema/cubi-estate-agent-alert-subscribe-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/cubi-estate/json-schema/cubi-estate-agent-cross-city-search-request-schema.json

## Other Cubi Estate APIs (12)

- [Cubi MCP Connector](https://apis.io/apis/cubi-estate/cubi-mcp-connector/)
- [Cubi Estate Admin API](https://apis.io/apis/cubi-estate/cubi-estate-admin-api/)
- [Cubi Estate Alert API](https://apis.io/apis/cubi-estate/cubi-estate-alert-api/)
- [Cubi Estate Attr API](https://apis.io/apis/cubi-estate/cubi-estate-attr-api/)
- [Cubi Estate Blog API](https://apis.io/apis/cubi-estate/cubi-estate-blog-api/)
- [Cubi Estate Chat API](https://apis.io/apis/cubi-estate/cubi-estate-chat-api/)
- [Cubi Estate Cities API](https://apis.io/apis/cubi-estate/cubi-estate-cities-api/)
- [Cubi Estate Compare API](https://apis.io/apis/cubi-estate/cubi-estate-compare-api/)
- [Cubi Estate Concept Pairs API](https://apis.io/apis/cubi-estate/cubi-estate-concept-pairs-api/)
- [Cubi Estate Conference API](https://apis.io/apis/cubi-estate/cubi-estate-conference-api/)
- [Cubi Estate Contact API](https://apis.io/apis/cubi-estate/cubi-estate-contact-api/)
- [Cubi Estate Countries API](https://apis.io/apis/cubi-estate/cubi-estate-countries-api/)

## Tags

Agents

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cubi-estate/cubi-estate-agent-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cubi-estate/.