---
name: real-agent-buyers
mcp:
  command: node
  args:
    - ${PLATFORM_ROOT}/lib/mcp-spawn-tee/dist/index.js
    - ${PREMIUM_PLUGINS_ROOT}/real-agent/plugins/buyers/mcp/dist/index.js
  env:
    MCP_SPAWN_TEE_NAME: buyers
    LOG_DIR: ${LOG_DIR}
    PLATFORM_ROOT: ${PLATFORM_ROOT}
    ACCOUNT_ID: ${ACCOUNT_ID}
    SESSION_ID: ${SESSION_ID}
mcp-manifest: auto
description: "Full buyer lifecycle — enquiry handling, qualification, viewing management, feedback collection, educational guides, the public-chat property recommender, and the visitor-graph analytics that link page behaviour to known :Person contacts."
tools:
  - name: visitor-recent-by-person
    publicAllowlist: false
    adminAllowlist: true
    riskClass: read
  - name: visitor-recent-by-page
    publicAllowlist: false
    adminAllowlist: true
    riskClass: read
  - name: visitor-engagement-score
    publicAllowlist: false
    adminAllowlist: true
    riskClass: read
  - name: visitor-recommendation-ctr
    publicAllowlist: false
    adminAllowlist: true
    riskClass: read
  - name: visitor-session-detail
    publicAllowlist: false
    adminAllowlist: true
    riskClass: read
  - name: visitor-event-ingest
    publicAllowlist: false
    adminAllowlist: true
    riskClass: write_local
  - name: visitor-backfill-from-logs
    publicAllowlist: false
    adminAllowlist: true
    riskClass: write_local
  - name: mint-visitor-token
    publicAllowlist: false
    adminAllowlist: true
    riskClass: write_local
always: false
metadata: {"platform":{"optional":true,"embed":["public","admin"]}}
---

# Real Agent — Buyer Management

Six skills covering the complete buyer lifecycle from initial enquiry through viewing management and educational content, plus the public-chat property recommender that fires on visitor buyer intent.

## When to Activate

The user is handling buyer enquiries, qualifying applicants, managing viewings, collecting post-viewing feedback, or providing educational guides for buyers and sellers at different life stages.

## Skills

| Skill | Purpose |
|-------|---------|
| `buyer-management` | Full buyer lifecycle — enquiry, qualification, viewing, feedback, offer |
| `buyer-feedback` | Post-viewing feedback collection via conversational check-in |
| `property-enquiry` | Structured intake for new buyer enquiries — requirements, finances, timeline |
| `property-recommender` | Public-chat skill — render a property card (image + blurb + listing URL) on buyer intent, sourced from `:Listing` and `:ImageObject` via memory-search |
| `viewing-management` | Viewing lifecycle — booking, confirming, rescheduling, reminders |
| `buyer-seller-guides` | Educational guides for buyers and sellers — first-time, upsizing, downsizing, probate |

## Tools Used

Skills operate via existing platform tools plus the visitor-graph MCP:

- `memory-search` — retrieve domain knowledge from the knowledge base
- `visitor-recent-by-person` — recent :Session activity for a :Person (morning round, 1:1 prep)
- `visitor-recent-by-page` — who has viewed a listing recently (operator side-bar)
- `visitor-engagement-score` — engagement-ranked :Person list (nurture queue)
- `visitor-recommendation-ctr` — recommendation CTR over a window, joined from `:Recommendation` and `:Click` nodes
- `visitor-session-detail` — full event timeline for one :Session
- `visitor-event-ingest` — admin-side companion to `POST /v/event` for test harness work
- `visitor-backfill-from-logs` — one-shot importer for `[property-recommended]` and `[property-card-click]` log lines, used to recover late-arriving sessions
- `mint-visitor-token` — sign a `&v=<token>` value bound to a `:Person` so outbound URLs in morning-round / lead-nurturing / vendor-updates attribute clicks back to the recipient

## References

Domain knowledge files loaded on demand by each skill. See individual skill files for their specific reference listings.