Summarized web edition
This page is the concise web copy of the full RAILS research paper. The complete whitepaper expands the analysis, source notes, implementation artifacts, and appendices for board, legal, security, and technical review.
The RAILS Framework
A capability-without-custody architecture for safe, compliant, and responsible agentic AI in real estate.
A governance and technical framework for boards, MLSs, brokerages, professional associations, regulators, and technology vendors.

The boundary
AI may receive capabilities. It must not receive custody.
The control
Policy, identity, and authorization remain outside the model.
The accountability
Licensed humans and approved platforms retain consequential authority.
This is a governance and technical architecture proposal, not legal advice and not an adopted industry standard. Any implementation must be validated against the laws, professional rules, data agreements, consent obligations, and vendor contracts that apply in its jurisdiction.
Realtors already crossed the AI adoption threshold. Governance has not.
Boards are not deciding whether members will begin using AI. Members are already using it in production work, often through general-purpose tools that sit outside a board-defined identity, permission, retention, provenance, and audit layer.
82%
of surveyed U.S. NAR-member real estate professionals said they currently use AI.
68%
reported using AI daily or several times per week.
63%
named accuracy or reliability as a concern.
49%
named compliance or legal issues as a concern.
The RPR 2026 AI Adoption Survey also found that 92% use AI now or plan to, 71% identify time savings as its leading value, and 68% save at least one hour per week. The survey was self-reported by 225 U.S. NAR-member real estate professionals, so it should not be generalized as a census of every market. Read the full RPR survey .
Interactive evidence review · Q5–Q13
Adoption is broad, frequent, valuable—and already touching higher-risk work
Select any bar, point, segment, or response label to inspect its exact share and count. Question-level respondent totals vary from 196 to 223; multi-select questions do not sum to 100%.
Types of AI tools agents have used
Writing tools (social posts, emails, descriptions): 77.93% (173 respondents). The category describes tool type, not the data entered into it.
Where AI is already affecting the real estate workflow
RAILS groups the survey’s tasks by workflow family; the horizontal position is the exact reported share. The grouping is analytical, not an additional survey measure.
Content
Communication
Market & property
Pipeline
No active use
Other
Writing listing descriptions: 68.47% (152 respondents).
Frequency of AI use for real estate tasks
Daily: 81 respondents. Daily plus several-times-weekly use totals 68.16%.
Average time saved each week
None: 28 respondents. The source report rounds this combined result to 68%.
Confidence using AI-generated content with clients
Stacked confidence distribution. Select a segment for its exact response.
Somewhat confident: 80 respondents. Confident plus very confident totals 47.53%; the remaining 52.46% were somewhat or not confident.
Where agents feel AI delivers value
Saving time: 70.97% (154 respondents). Productivity dominates, but almost one-third already cite pricing and market analysis.
Concerns about using AI in real estate
Accuracy of outputs: 63.47% (139 respondents). Accuracy, compliance, and market-data interpretation are governance problems, not prompt-writing problems.
Capabilities agents want RPR to expand
More CMA enhancements: 66.84% (131 respondents). The two leading requests move directly toward pricing and market interpretation.
Biggest barrier to using AI more regularly
I do not have any major barriers: 33.64% (74 respondents). No major barriers is the largest single response, but it is a 33.64% plurality—not a majority.
The survey does not directly measure board oversight. The governance conclusion is an inference: when adoption is already embedded in member workflows, the practical choice is no longer AI versus no AI. It is governed, permissioned paths versus unmanaged workarounds with weaker visibility and fewer shared controls. What members can already delegate is measurable: HomieBench v5 benchmarks eight frontier models across 100 supervised realtor workflows.
The detailed answers sharpen that inference. In Q5, 38.74% reported using market analysis or pricing tools and 22.52% reported AI CMA tools. In Q7, 30.63% reported analyzing market trends and 24.32% reported running CMAs or pricing conversations. One qualitative respondent also said they use AI heavily when processing trends from MLS data. The survey does not establish how common it is for members to paste MLS, client, or transaction data into a model, but it demonstrates enough high-stakes use to make data-flow controls urgent.
Training, retrieval, and live data are different mechanisms.
A realtor entering information into a consumer AI service can create confidentiality, retention, and model-improvement risk depending on the product and account settings. It does not give the base model a real-time private IDX connection, and it does not explain every current market answer. OpenAI says individual-service content may be used to improve models unless the user opts out, while its business products and API are excluded by default; Anthropic likewise distinguishes consumer choices from commercial products. Up-to-date answers may instead come from web search, a connected tool, a public webpage, or context supplied in the current conversation. See the official data-use explanations from OpenAI and Anthropic , plus the current-search documentation for ChatGPT and Claude .
Adoption is ahead of governance. Waiting does not preserve the status quo; it cedes the control surface.
Abstract
Agentic AI is becoming an interface through which consumers and professionals discover information, compare options, make decisions, and initiate action. In real estate, the interface that captures the question also captures commercially valuable intent: preferences, search refinements, objections, timelines, affordability constraints, and next steps.
Boards and MLSs therefore face two risks at once. Blanket prohibition can push members toward ungoverned consumer tools and workarounds. Unrestricted access can transfer protected listing, client, and transaction data into systems that were not designed to govern it. Neither extreme is durable.
The AI may receive capabilities. It must not receive custody.
RAILS—the proposed Realtor Agentic Interoperability Layer Standard—keeps protected data in its proper system of record while exposing narrowly scoped, identity-bound, purpose-bound, auditable capabilities. Models may search, summarize, prepare, validate, or request an action. They do not receive feed credentials, become the CRM, persist a shadow listing database, create the authoritative contract in an unapproved sandbox, or apply a signature.
The result is a model-agnostic architecture that combines zero trust, least privilege, purpose limitation, split-channel secure rendering, deterministic computation, human approval for consequential actions, immutable audit events, and capability-level vendor certification.
The risk is interface displacement—not simply data access.
Organized real estate was built around cooperation: competing professionals shared inventory under common rules for attribution, access, display, accountability, and data quality. That cooperative infrastructure also created an information advantage. AI and open distribution are reducing the marginal cost of basic access and interpretation.
Figure 1
Where professional value moves
Historic value stack
Durable professional value
The professional does not disappear when information becomes cheaper. The professional’s comparative advantage moves toward fiduciary alignment, judgement under uncertainty, negotiation, risk ownership, service coordination, and accountable execution. The board’s advantage changes in parallel: from information scarcity toward identity, permission, provenance, quality, interoperability, auditability, and revocation.
The market is already showing this shift. In October 2025, Zillow and OpenAI launched a conversational listing experience inside ChatGPT. Zillow says it controls the rendered experience, does not send OpenAI a raw MLS feed, and preserves MLS attribution and field controls. That architecture is a live example of a capability being made available without transferring feed custody. See the primary announcements from Zillow and Zillow’s industry explanation .
In June 2026, HouseCanary described a national expansion of Google’s mobile home-discovery program using listings from participating MLSs with broker and agent attribution. The announcement is evidence of real-estate discovery moving into a horizontal intent layer, although it should not be read as proof of any architecture beyond what the publisher describes. See the HouseCanary announcement .
Tool-connected AI is also becoming portable. OpenAI’s Apps SDK is built on the Model Context Protocol; Anthropic describes MCP as an open standard for connecting AI systems to external tools and data. These facts do not prove that every portal will integrate with every model. They do establish the interface pattern: natural-language request, controlled tool call, external system, structured result, and rendered experience. See OpenAI and Anthropic .
Figure 2
The board’s strategic choice
Controlled stagnation
Restrictions hold, but useful member workflows remain underdeveloped.
Interface displacement
Members adopt workarounds while external platforms capture intent and workflow.
Governed innovation
Certified tools improve member capability while boards retain policy control.
Partial alignment
Approved paths exist, but external incentives still require active oversight.
The choice is not “AI or no AI.” It is whether adoption happens inside a governable perimeter or outside one. Governed access creates new diligence and enforcement work, but it also gives boards a path to set requirements, certify capabilities, monitor use, revoke access, and keep professional accountability visible.
Capability, not custody
Custody exists when a model provider, agentic harness, or vendor application can persist, redistribute, train on, broadly index, or become an alternate source of truth for protected data. Capability exists when an authenticated actor can request one defined business action through a controlled service with bounded input, output, purpose, retention, and side effects.
Figure 3
Capability crosses the boundary. Custody does not.
CRM
Client and consent records
MLS / IDX / VOW / DDF
Listing and market data
Transaction platform
Authoritative documents
Policy & capability gateway
- Identity + purpose
- Field minimization
- Rate + scope limits
- Approval + audit
Agentic interface
Receives a bounded result, opaque reference, secure view, or approved action status—not raw feeds, signing keys, or authoritative custody.
Good capability design
- listings.search_display
- cma.prepare
- market_stats.calculate
- crm.task_create
- transaction.validate
- transaction.dispatch_approved
Unsafe generic access
- run_sql
- download_feed
- export_all_contacts
- read_any_record
- sign_document
- unrestricted_browser
Every capability should declare its eligible actors, allowed purpose codes, data classes, result ceilings, risk tier, human approval requirement, retention class, audit events, failure behaviour, and revocation path. Credentials remain at the gateway or system of record; they never enter model context.
- The model is never the system of record.
- Protected data is purpose-bound and minimized.
- Credentials and signing keys never enter model context.
- Deterministic services calculate and validate where correctness matters.
- Consequential actions remain attributable to an authorized human.
- Every access is observable, revocable, and auditable.
- Interfaces remain model-agnostic to reduce platform lock-in.
- Human-rights, privacy, and professional duties are enforced by design.
Three protected data domains, three proper systems of record
A workable policy must stop treating “real-estate data” as a single class. Listing, client, and transaction data carry different permissions, risks, and authoritative systems. RAILS applies the same boundary to all three while preserving those differences.
Consumer and client data
Identity, contact, finances, motivations, search preferences, consent, notes, and communications.
- System of record
- Approved CRM or brokerage business system.
- Permit
- Minimum fields for a declared task; pseudonymous references; scoped task, note, or draft creation.
- Prohibit
- Database copies in prompts or memory; unrestricted search; cross-tenant access; training or feedback use.
Listing and market data
Active and historical listings, media, remarks, sold data, showing data, statistics, and display instructions.
- System of record
- Board/MLS source and approved IDX, VOW, DDF, RESO-aligned, or participant application.
- Permit
- Permissioned search, secure rendering, deterministic CMA/statistics, and opaque report references.
- Prohibit
- Raw feed transfer, generic SQL, bulk extraction, confidential-field leakage, shadow indexes, or unauthorized scraping.
Transaction and contract data
Agreements, offers, amendments, disclosures, signatures, dates, review records, and correspondence.
- System of record
- Approved forms, transaction-management, document-management, compliance, or e-signature platform.
- Permit
- Form selection, proposed fields, validation, exact-version review, and approved platform dispatch.
- Prohibit
- Authoritative documents in an AI sandbox; autonomous signature or delivery; post-approval mutation.
Split-channel secure rendering
Protected listing detail does not always need to enter the model’s natural-language context. The model can receive a count, an opaque widget reference, policy metadata, and a secure view URL. The user interface then retrieves the authorized listing component directly from the IDX, VOW, DDF, brokerage, or board-controlled origin. The display channel and the model channel remain separate.
This pattern is compatible with existing permission-based distribution models. CREA describes REALTOR.ca DDF® as a managed, permission-based service in which broker owners control how listing content is shared. RESO publishes current Web API and Data Dictionary specifications that can provide common vocabulary for capability schemas. See CREA DDF® and RESO specifications .
Figure 6
Prepare → review → approve → commit
Prepare
AI proposes structured fields
Render
Approved platform builds exact version
Validate
Rules, dates and required fields
Review
Licensed human sees immutable artifact
Approve
Approval binds to document hash
Commit
Platform dispatches and archives
A trust architecture around the model—not inside it
RAILS separates probabilistic interpretation from identity, authorization, calculation, recordkeeping, and binding execution. A model may infer what a user is trying to achieve; it does not decide whether the user is entitled to achieve it.
Figure 4
RAILS reference architecture
Experience
Professional workspace, consumer portal, mobile app
Orchestration
Planning, model routing, task state, tool selection
Policy & identity
OIDC/OAuth, MFA, roles, attributes, purpose, consent
Capability gateway
Fixed schemas, field filters, limits, approval gates
Systems of record
Listing, CRM, forms, transaction, document and signature platforms
Audit, provenance & incident
Trace IDs, hashes, policy versions, anomaly detection, revocation
The policy and identity plane evaluates the subject, action, resource, data class, purpose, consent, jurisdiction, time, and risk tier. The capability gateway then asks the authoritative application to perform the action. The default response is the minimum sufficient projection—not the entire underlying resource.
allow = policy(
subject,
action,
resource,
data_class,
purpose,
consent,
jurisdiction,
time,
risk_tier
)
result = minimize(authoritative_data, purpose, role, consent, policy)This architecture follows the same direction as zero-trust systems: no implicit trust based on location or ownership, explicit authentication and authorization, and policy focused on users, services, and resources. NIST SP 800-207A further describes granular application-level policy enforcement through gateways and service identities. See NIST SP 800-207 and NIST SP 800-207A .
The coding agent may change the IDX website. The IDX website must control the live data.
Realtors and brokerages already use authorized IDX websites and applications to present listing information under applicable agreements, board rules, display requirements, and participant control. Coding agents can also modify website code. RAILS combines those facts without creating a new raw-data entitlement: the approved IDX application remains the only runtime permitted to hold credentials, query live listing data, enforce field and display rules, and render the result.
NAR’s current IDX policy describes authorized display through participant-controlled websites, mobile apps, and other approved mechanisms, requires the participant to control how listings are displayed, and states that MLS database access may not be given to an unauthorized person or entity. See NAR IDX Policy Statement 7.58 . In Canada, CREA describes DDF® as a permission-based distribution service and a Member Website Feed for listing display on a member-controlled website; see REALTOR.ca DDF® .
Figure 5
The controlled IDX website boundary
Board / MLS source
Listing data, credentials, field permissions, refresh, attribution, and distribution rules remain protected.
Approved IDX website / application
Live query
Executes server-side
Policy
Applies display rules
Render
Returns coded outcome
Consumer or realtor page
Buyer search, neighbourhood page, property experience, or deterministic home evaluation with current permitted data.
Coding agent
Edits templates, components, schemas, tests, mock fixtures, and approved query definitions. It does not receive feed credentials, query the live database, or ingest the raw IDX payload.
The coding agent changes the experience. The approved IDX application controls the data.
The model may help create a custom buyer-search page, neighbourhood experience, listing comparison, property page, or deterministic home-evaluation workflow. It can edit React components, templates, schemas, tests, mock fixtures, explanatory copy, and approved parameterized query definitions. It must not receive the raw feed, reuse feed credentials, query the live database, create a shadow index, or copy bulk listing data into model memory.
Permitted development plane
Documented schemas, approved SDKs, redacted fixtures, mock listing records, component code, query definitions, validation, display tests, and deployment review.
Protected runtime plane
Feed credentials, live IDX payloads, confidential fields, database access, refresh, attribution, field entitlements, rate limits, consumer audit, and production queries.
Coded buyer-search outcome
The agent builds the page and constrained filters. The IDX server validates the query, executes it live, and renders current permitted listings.
Coded home-evaluation outcome
The agent builds the intake and explanation. Approved services retrieve permitted inputs and run deterministic calculations, with provenance and licensed review.
capability: idx.page.render
actor: participant_controlled_website
agent_visibility: [schema, mock_fixture, query_definition, rendered_metadata]
agent_prohibited: [feed_credential, live_database, raw_payload, bulk_export]
runtime:
execute_query: approved_idx_application
enforce: [field_permissions, attribution, freshness, display_rules, rate_limits]
output:
returns: [rendered_page_ref, result_count, data_as_of, provenance]
deployment:
tests_required: [query_bounds, prohibited_filters, attribution, stale_data, extraction]
human_approval: requiredRESO notes that its Web API can execute live queries for immediate results in web applications and defines an IDX payload as the structured fields needed for display on an IDX website. RAILS places that live query and payload handling inside the authorized application boundary—not inside model context. See the RESO Web API overview .
- The website or approved application—not the model—is the data recipient and runtime.
- The coding agent receives schemas, fixtures, and opaque result references, not feed credentials.
- Live queries execute server-side under participant identity, purpose, and policy.
- Rendered pages preserve attribution, freshness, filtering, display, and access requirements.
- Every deployed code or query-definition change is tested, reviewed, versioned, and reversible.
- Boards can audit and revoke the application capability without granting access to the model.
A Realtor Agent Capability Catalogue for showings, CRM follow-up, social media, and conversations
RAILS is not only a listing-search architecture. The same capability-without-custody boundary applies to the repetitive workflows that realtor tools are beginning to automate. Each workflow needs a named action, authorized actor, purpose, minimum data, deterministic checks, human boundary, audit event, and revocation path.
Showing coordination
Read permissioned availability; request, reschedule, or cancel; reconcile calendars; securely render instructions; record every decision.
CRM follow-up
Create tasks, notes, appointments, and bounded stage changes in Follow Up Boss, HighLevel, Lofty, BoldTrail, or another approved CRM.
Social production
Transform approved source material, verify facts and rights, obtain human approval, publish through official APIs, and store post provenance.
DM and conversation handoff
Respond within channel rules, capture explicit lead information, stop on opt-out or ambiguity, and transfer consequential advice to a realtor.
Agent-to-agent showing booking: ShowingTime API, BrokerBay API, Touchbase API, Aligned Showings API, SentriKey Showing Service API, Instashowing API, and Showingly MCP
Showing coordination is a strong candidate for a board-defined agent-to-agent profile. A buyer agent’s AI should be able to ask a listing agent’s authorized service for permitted availability, submit one traceable request, receive an approval, counter-time, or decline, and reconcile both calendars. Neither model needs the other realtor’s password, browser session, seller instructions, alarm code, lockbox data, or full client record.
The workflow crosses realtor identity and delegation, listing status, buyer context, calendars, seller or tenant approval, appointment state, secure access instructions, notifications, and feedback. That makes a normal browser session too broad and an unstructured chat between bots too weak. The system of record must authorize and execute each state transition.
| Platform | What the publisher documents | RAILS finding |
|---|---|---|
| ShowingTime / ShowingTime+ | A Real-Time Availability API and partner booking integrations. | Useful precedent, but the public material reviewed does not document a self-serve, full-lifecycle create, respond, reschedule, cancel, and secure-instruction API for a realtor’s own agent. |
| BrokerBay, Touchbase, Aligned Showings, SentriKey Showing Service, Instashowing | Web and mobile scheduling, approval, calendar, notification, routing, access, and feedback workflows. | The public-documentation review did not surface a self-serve developer API covering the complete delegated booking lifecycle. Private, MLS, or partner integrations may exist and should not be conflated with a public agent-ready surface. |
| Showingly | Private-beta pricing explicitly advertises an embeddable widget, REST API, and remote MCP server for AI agents. | An emerging exception and a useful direction of travel, subject to normal diligence on identity, scopes, audit, data rights, and production maturity. |
Review the current publisher material for ShowingTime+ , BrokerBay , Touchbase , Aligned Showings , SentriKey Showing Service , Instashowing , and Showingly API and MCP access . Zillow’s Real-Time Touring also documents a ShowingTime-integrated consumer and agent flow; see Zillow .
- 01
Delegate
Each realtor authorizes their own agent with a short-lived, tenant-bound token and explicit showing scopes.
- 02
Discover
The buyer-side agent reads permitted slots without receiving seller notes, alarm data, or lockbox credentials.
- 03
Request once
A create call carries buyer-context reference, requested slots, purpose, trace ID, and idempotency key.
- 04
Apply listing policy
The listing-side service checks status, showing rules, calendar conflicts, and required human or seller approval.
- 05
Reconcile
Both sides receive the authoritative status by webhook; calendars update from the appointment reference.
- 06
Reveal securely
Only after confirmation, entitled users retrieve time-bound access instructions through a separate secure channel.
framework_version: rails/1.4
profile_schema: rails-capability-profile/1.0
capability: showing.request_create
eligible_roles: [licensed_realtor, authorized_assistant]
required_scopes: [showing:availability_read, showing:request_create]
delegation:
subject: realtor_id
tenant: board_or_brokerage_id
token_ttl: short
input:
listing_ref: opaque
requested_slots_max: 3
buyer_context_ref: crm-scoped
idempotency_key: required
policy:
listing_status_current: required
calendar_conflict_check: required
agency_and_consent_state: required
output:
returns: [request_ref, status, expiry, secure_instruction_ref]
model_visibility: no_lockbox_or_confidential_instructions
human_review: required_on_exception
audit: signed_tamper_evident_events
revocation: immediate- showing.availability_read
- showing.request_create
- showing.request_respond
- showing.request_reschedule
- showing.request_cancel
- showing.instructions_render_secure
- showing.feedback_submit
AI Follow Up Boss, AI GoHighLevel, AI Lofty CRM, AI kvCORE / BoldTrail, Sierra Interactive, CINC, Real Geeks, BoomTown, Wise Agent, and Top Producer
Search demand is clustering around specific realtor tools, but the governance unit should remain the capability. The 84-system integration directory maps this landscape with documented access status for every system. Follow Up Boss documents a REST API and signed webhooks. HighLevel exposes contacts, conversations, calendars, opportunities, payments, and a broad webhook catalogue. Lofty documents developer access to leads, listings, transactions, communications, and AI features. BoldTrail is the current ecosystem name associated with kvCORE. Sierra Interactive, CINC, Real Geeks, BoomTown, Wise Agent, Top Producer, HubSpot, Salesforce, and other CRMs vary in partner access, object coverage, and commercial terms.
RAILS should make those differences explicit while preserving common actions: crm.person_match, crm.note_create, crm.task_create, crm.appointment_create, crm.stage_propose, and crm.opt_out_record. See the developer materials for Follow Up Boss , HighLevel , and Lofty .
AI offer writing in SkySlope, CREA WEBForms, Lone Wolf Transactions, zipForm, TransactionDesk, dotloop, Form Simplicity, DocuSign, and Authentisign
Offer preparation is where a convenient browser workaround can become an authoritative legal-document problem. Common Canadian and U.S. systems include SkySlope, CREA WEBForms powered by TransactionDesk, Lone Wolf Transactions (zipForm Edition), Lone Wolf Transactions (TransactionDesk Edition), dotloop, Form Simplicity, Authentisign, DocuSign, Brokermint, Paperless Pipeline, Glide, and brokerage-specific compliance portals. The approved form library, brokerage rules, identity, audit, and exact document version must remain attached to the workflow.
CREA describes CREA WEBForms as an end-to-end document and transaction-management product powered by TransactionDesk. Product access through a member interface does not itself authorize an agentic browser to reuse that member’s credentials or session.
Several vendors already provide safer integration paths. SkySlope documents transaction-management APIs and an Offers API; Lone Wolf publishes partner APIs for TransactionDesk, zipForm, Transact, and Deals; dotloop documents an OAuth 2.0 public API; Form Simplicity documents scoped transaction endpoints; and DocuSign exposes its eSignature REST API. See SkySlope , SkySlope Offers , Lone Wolf , dotloop , Form Simplicity , and DocuSign .
A board or brokerage may also approve a self-hosted signing service such as DocuSeal , which documents on-premises deployment plus API and webhook support. Open source does not by itself establish legal validity, security, insurance coverage, retention compliance, or approved-form rights; those still require diligence and policy. Nano-PDF is an open-source AI PDF-editing CLI that recreates pages and restores searchable text with OCR. It may help with nonbinding presentation material, but it is not an e-signature or transaction system of record and should not generate or mutate authoritative offer forms. See the Nano-PDF project description .
- forms.template_read
- transaction.draft_create
- transaction.fields_propose
- transaction.validate
- esign.envelope_create_draft
- transaction.dispatch_approved
AI social media for realtors: OpusClip, SumoClip, Higgsfield, Zernio, and ManyChat
A governed social agent can transform approved source material with AI clipping, create disclosed synthetic assets or presenter variants, obtain exact-artifact human approval, publish through official platform APIs, manage permitted comment and DM workflows, and write qualified leads back to the CRM. It should not scrape social dashboards, invent listing facts, reuse media without rights, impersonate a realtor, or continue a conversation outside platform and consent rules.
The follow-up Homies Research paper, The Real Estate Social Media AI Agent Stack, covers OpusClip, SumoClip, Supo, Higgsfield AI clones, the Zernio API, ManyChat, CRM integration, cost, measurement, and human-review controls in detail.
“We do not train on your data” is not a retention policy
A model request necessarily processes some input during inference. “No data in the model” is therefore useful shorthand but not an enforceable specification. The policy must enumerate every place protected information may persist.
Training and fine-tuning
Provider abuse-monitoring logs
Conversation history
Model memory
Assistant or thread state
Files and vector stores
Prompt caches
Tracing and observability
Tool, connector, browser, and subprocessor logs
A defensible vendor matrix identifies retention by endpoint and feature, training and feedback status, memory defaults, file lifecycle, cache behaviour, trace redaction, human-review exposure, subprocessors, residency, deletion verification, encryption, and incident obligations. Consumer accounts should not be used for protected workflows.
In Canada, organizations subject to PIPEDA must address accountability, identified purposes, consent, limiting collection, limiting use/disclosure/retention, accuracy, safeguards, openness, access, and challenge rights. Provincial law and sector-specific rules may also apply. See the Office of the Privacy Commissioner of Canada .
The proposed rule is precise: protected real-estate data may not be used for training, fine-tuning, model improvement, feedback, persistent memory, reusable retrieval indexes, model-managed files, or long-lived application state unless every party with the legal authority to permit that use has done so. Transient processing must be minimized, purpose-bound, encrypted, contractually protected, and subject to the shortest available retention.
Agentic systems expand the attack surface because they can act
Traditional application security remains necessary, but an agent adds instruction interpretation, tool selection, workflow state, and cross-system action. Controls must assume that retrieved content can be hostile and that a fluent model output can still be wrong or manipulative.
| Threat | Real-estate failure mode | Required controls |
|---|---|---|
| Prompt injection | Malicious instructions in remarks, CRM notes, email, documents, or webpages. | Treat retrieved content as data; isolate instructions; external policy engine; fixed output schemas. |
| Tool misuse | A legitimate capability is called with dangerous parameters, frequency, or scale. | Server-side validation, result ceilings, query budgets, rate limits, read/write separation, confirmation. |
| Identity and privilege abuse | A user, model, or connector exceeds its role, tenant, purpose, or jurisdiction. | Short-lived tokens, audience restriction, per-tool scopes, tenant isolation, step-up authentication. |
| Supply-chain compromise | A tool, MCP server, package, or vendor integration changes or is subverted. | Approved registry, pinned versions, signed manifests, SBOM/AIBOM, monitoring, emergency revocation. |
| Unexpected code execution | A production agent obtains shell, filesystem, or unrestricted network access. | No production shell, sandboxed execution, egress allowlists, ephemeral compute, reviewed deployment paths. |
| Credentialed browser control | An agent inherits a member's password, cookies, MFA-approved session, or broad UI permissions to operate a system with no supported integration. | Prefer delegated APIs; prohibit credential entry into model context; isolate any approved browser fallback; require session recording, domain allowlists, human confirmation, and rapid revocation. |
| Memory and context poisoning | False or hostile state is stored and reused as if authoritative. | No protected-workflow long-term memory; authoritative records; signed provenance; expiry and reconciliation. |
| Human trust exploitation | A plausible explanation is mistaken for legal, valuation, or compliance authority. | Source and freshness display, uncertainty, review checklists, and friction for consequential actions. |
The OWASP Top 10 for Agentic Applications 2026 provides a useful cross-industry baseline. NIST’s voluntary Generative AI Profile organizes risk work around governance, mapping, measurement, and management. RAILS translates those foundations into real-estate-specific data and action boundaries; it does not replace either framework.
Audit events should be append-only and include trace ID, actor, tenant, capability, purpose, risk tier, resource reference, request/response hashes, policy version, authorization result, approval reference, outcome, and retention class. Raw protected payloads should not be logged by default.
Models may explain. Authoritative systems must calculate and verify.
A model can help a professional reason about a result, but it should not free-form a CMA, filing deadline, disclosure decision, binding form, or protected-field determination. Deterministic services should calculate comparable filters, distances, date windows, prices, adjustments, mortgage figures, taxes, deadlines, required fields, signature completeness, and document hashes.
- Source
- Authoritative system and record reference
- Time
- Retrieved at and data-as-of timestamps
- Permission
- Actor, tenant, purpose, and field context
- Versions
- Policy, tool, calculation, and schema
- Method
- Material assumptions and result limits
- Review
- Human-review requirement and approval ID
{
"result_ref": "cma_01J...",
"source": "approved-vow-service",
"retrieved_at": "2026-07-14T14:21:08Z",
"data_as_of": "2026-07-14T14:19:55Z",
"policy_version": "board-agentic-policy-1.2",
"tool_version": "cma-service-3.4.1",
"calculation_version": "adjustments-2.0",
"model_visibility": "metadata_only",
"human_review_required": true
}Objective criteria, explainable trade-offs, and anti-steering by design
Agentic interfaces can amplify discrimination when they accept protected-class preferences, infer them from proxies, or translate vague language into demographic steering. The design rule is consistent even where specific protected grounds differ: do not accept, infer, optimize, or conceal protected-class criteria.
Unsafe request
“Find me a family neighbourhood without immigrants.”
Required transformation
Reject the protected-class criterion. Offer objective alternatives such as budget, commute, property type, accessibility, lot size, parks, transit, or other legally appropriate housing attributes.
- Maintain prohibited-feature and proxy-feature catalogues.
- Log the objective criteria that include or exclude each result.
- Explain trade-offs rather than rank communities as good or bad.
- Test recommendations and ad delivery for disparate patterns.
- Escalate ambiguous requests to an authorized human.
- Apply the specific law and professional rule of each jurisdiction.
Ontario’s Human Rights Code protects equal treatment in buying, selling, and renting housing on Code-protected grounds. In the United States, HUD guidance identifies risks including denying housing information, differential terms, and steering through digital advertising. See the Ontario Human Rights Commission and HUD’s digital-platform guidance . Implementers must verify current local law rather than reuse either list as a universal rule.
Certify capabilities—not vendors in the abstract
A vendor may be suitable for secure listing rendering and unsuitable for transaction dispatch. A brokerage tool may be approved to create a CRM task and prohibited from bulk export. Certification should therefore attach to a capability, data class, actor, purpose, and risk tier—not to a logo.
| Tier | Class | Examples | Approval boundary |
|---|---|---|---|
| 0 | Prohibited | Raw-feed transfer, training on protected data, autonomous signatures, cross-tenant access | None |
| 1 | Read and navigate | Public/permissioned search, source attribution, secure rendering | Review before reliance |
| 2 | Authenticated analysis | VOW search, CMA preparation, market statistics, deterministic calculations | Human review before sharing |
| 3 | Workflow write-back | CRM notes, tasks, showing requests, drafts, scheduling, bounded internal updates | Confirm external communication |
| 4 | Transaction preparation | Form selection, field population, clause proposal, validation | Licensed-human review required |
| 5 | Binding or external action | Send for signature, deliver an offer/notice, release confidential information | Step-up auth + exact-version approval |
Figure 8
Higher capability buys a heavier human gate
Prohibited
No path to approval
Raw-feed transfer, training on protected data, autonomous signatures
Read and navigate
Review before reliance
Permissioned search, attribution, secure rendering
Authenticated analysis
Human review before sharing
VOW search, CMA preparation, deterministic statistics
Workflow write-back
Confirm external communication
CRM notes, tasks, drafts, bounded internal updates
Transaction preparation
Licensed-human review required
Form selection, field population, clause proposal
Binding or external action
Step-up auth + exact-version approval
Send for signature, deliver an offer, release confidential information
Evidence should include architecture and data-flow diagrams, a field-level data inventory, model and subprocessor lists, retention matrices, training-use commitments, tenant-isolation tests, OAuth scopes, tool schemas, red-team results, fair-housing or human-rights testing, approval design, audit-event catalogues, incident response, business continuity, kill-switch procedures, deletion evidence, and software/AI bills of materials.
API first, MCP second, CLI for supervised operations
API, MCP, and CLI are complementary interfaces, not interchangeable security claims. Certification should follow the underlying capability and identity chain across every interface.
API · enforcement plane
The authoritative service validates identity, tenant, scope, purpose, input schema, idempotency, approval, rate limit, output minimization, audit, and revocation. This is the preferred business-action boundary.
MCP · agent adapter
The MCP server publishes understandable tools over the governed API. It must preserve delegated authorization and policy; it must not convert a member password, cookie, or admin token into a general-purpose agent tool.
CLI · supervised operations
A CLI is useful for approved administrators and developers to test integrations, reconcile records, rotate credentials, inspect audit metadata, or invoke an emergency kill switch. High-risk end-user actions still require the API's controls.
Browser · constrained exception
Use only when authorized, necessary, isolated, observable, and time-limited. A browser can access an interface; it does not create narrow scopes, stable schemas, idempotency, or a distinct delegated identity.
From feed governance to capability infrastructure
The same institutions that created permissioned distribution can expose controlled search, valuation support, statistics, geographic intelligence, rendering, compliance validation, attribution, and provenance endpoints. The strategic product is no longer only a feed. It is a governed capability platform that lets new interfaces operate on board-defined terms.
The model is not the accountable actor.
A model cannot hold a licence, professional insurance, a fiduciary duty, or disciplinary responsibility. The registrant, brokerage, board, and vendor retain the obligations their roles create.
A one-year path from policy inventory to transaction preparation
The safest adoption path increases capability only after the preceding control layer has been demonstrated. Boards should begin with inventory and a narrow read-only path, not a high-risk transaction automation showcase.
- 0–90 daysPhase 1
Policy and inventory
Map systems and data classes; identify shadow AI; define prohibited uses; create legal, privacy, security, technical, and member governance.
- 90–180 daysPhase 2
Read-only and showing pilot
Certify narrow search, secure rendering, and showing-availability capabilities; test injection, extraction, attribution, field permissions, and revocation.
- 180–270 daysPhase 3
Agent-to-agent workflows
Add idempotent showing requests, deterministic CMA/statistics, and purpose-bound CRM tools with shared audit events and privacy-impact review.
- 270–365 daysPhase 4
Transaction preparation
Integrate approved forms platforms; bind human approval to immutable document versions; keep dispatch platform-side.
- Year 2Phase 5
Standards and scale
Publish an Agentic Access Profile, align schemas with RESO concepts, support multiple vendors, and operate red-team and incident-sharing programs.
Keeping the human in the loop: safe integration in one workflow
The tier progression stays abstract until it is applied to a single consequential workflow. Take the one members care about most: writing an offer.
In the first phase, the AI prepares structured field proposals inside a supervised harness. An approved form service selects the current template and runs deterministic checks; the realtor opens the draft in the system of record, reviews it, and completes the signing flow themselves. The model’s autonomy ends at a proposed draft. Nothing reaches a client that the realtor did not personally review and move.
In the second phase, the approved transaction API creates the draft from governed forms, records the AI-proposed fields, validates the instrument, and routes the exact version for signature. One rule changes: the signing order. The document goes to the realtor before the client. The realtor’s exact-version approval or professional attestation is recorded before the client ever sees it. Its legal effect depends on the instrument, the signer’s authority, and the jurisdiction; RAILS does not turn an internal approval into a signature or representation that local law does not recognize. Accountability becomes a verifiable property of the workflow rather than a procedural checkbox.
Figure 7
The human stays in the loop. The loop moves earlier.
AI drafts. The realtor executes everything.
AI writes the offer
Draft prepared from approved forms and validated fields
Realtor uploads it
The licensed human moves the document into the platform
Realtor signs
Review happens with hands on the instrument
Client signs
The client receives a human-executed document
AI drafts and routes. The realtor approves the exact version first.
AI writes the offer
Same drafting capability, same approved forms
AI uploads and routes
The platform receives the exact version for signature
Realtor approves first
A review or professional attestation is bound to the exact version
Client signs
The client only receives the exact human-approved document
The pattern generalizes across every tier in this framework. As autonomy increases, the human checkpoint does not disappear; it moves earlier and its consequences get heavier. The AI may earn more of a workflow only where the accountable human’s commitment is captured by a mechanism that cannot be skipped: a signature order, a document hash, a step-up approval. Section 14 shows the hash-bound version of the same idea, where approval binds to the exact document version and any later mutation invalidates it.
Phase two does not remove the human. It records the licensee’s exact-version approval before the client ever sees the AI-prepared instrument.
Success metrics should be operational: policy violations prevented, field-minimization rate, attribution correctness, tool-call failure rate, human-review completion, revocation time, incident detection time, unauthorized extraction resistance, and member time saved—not raw prompt volume.
Model policy clauses for counsel and rulemaking teams
The following clauses are starting points for jurisdiction-specific drafting. They are deliberately technology-neutral and preserve existing duties.
General authorization
A participant may use an approved agentic AI system to search, summarize, analyze, render, prepare, or initiate actions involving authorized data, provided the participant remains responsible and all existing data-use, display, privacy, professional-conduct, attribution, security, and supervision requirements continue to apply.
System of record
The agentic system must not serve as the authoritative repository for listing, client, or transaction data. Such data must remain within a board-approved, brokerage-approved, or legally authorized system of record.
Training and retention
Protected data may not be used to train, fine-tune, improve, evaluate, or provide feedback to a model unless expressly authorized by every party with the legal right to authorize that use. Persistent memory and unapproved retrieval storage are prohibited for protected workflows.
Listing boundary
Raw feeds, feed credentials, and bulk listing datasets may not be provided to a model or agentic harness. Access must occur through approved, narrowly scoped tools that preserve field permissions, display rules, attribution, freshness, and participant control.
IDX website execution boundary
An approved coding agent may prepare or modify participant-controlled IDX website code, templates, components, schemas, tests, and parameterized query definitions. Live listing queries, feed credentials, raw payloads, confidential fields, and database access must remain within the approved IDX application, which must enforce current field permissions, attribution, freshness, display, security, extraction, and audit requirements.
Agent-to-agent showing boundary
An AI may read permitted availability and initiate, respond to, reschedule, or cancel a showing only through an approved showing capability using delegated participant identity, purpose limitation, idempotency, authoritative appointment state, secure instruction handling, audit, and immediate revocation.
Client boundary
Client and consumer data must remain in an approved CRM or business system. Agentic access must be purpose-limited, consent-aware, least-privileged, logged, and restricted to the minimum information necessary.
Transaction boundary
Authoritative transaction instruments must be generated, versioned, stored, and executed within an approved platform. No potentially binding document may be issued or sent for signature without affirmative review and approval of the exact version by an authorized licensed human.
Interface hierarchy
Supported, scoped APIs are the preferred execution boundary. MCP and CLI interfaces must preserve the same identity, authorization, approval, audit, and revocation controls. Credentialed browser automation may be permitted only as a documented, least-privileged, supervised, time-limited exception and may not handle prohibited data or actions.
Audit and revocation
The board or MLS may require audit records reasonably necessary to investigate suspected misuse and may suspend or revoke a tool, integration, vendor, or participant capability where data security, consumer protection, or rule compliance is at risk.
A concrete, testable Agentic Access Profile
Natural-language policies are necessary but insufficient. Each approved capability should have a machine-readable profile that certification tests can exercise.
framework_version: rails/1.4
profile_schema: rails-capability-profile/1.0
capability: cma.prepare
risk_tier: 2
eligible_roles: [licensed_realtor]
required_scopes: [cma:prepare]
purpose_codes: [seller_evaluation, buyer_analysis, brokerage_review]
input:
schema: cma-request/2.1
max_records: 50
output:
model_visibility: metadata_only
returns: [cma_ref, secure_view_url, expiry, provenance]
human_review: required_before_share
retention_class: audit_metadata_only
revocation: immediateFor transactions, approval must bind to an immutable artifact. A later mutation must invalidate the approval and force a new review.
function dispatchApproved(documentBytes, approval) {
assert(approval.expiresAt > now())
assert(sha256(documentBytes) === approval.documentSha256)
assert(currentActor.id === approval.reviewerId)
assert(policyAllows("transaction.dispatch", approval.purpose))
// The approved platform holds the signing credential.
return transactionPlatform.dispatch(documentBytes, approval.id)
}Production implementations should use asymmetric signatures or a managed key service, short-lived tokens, replay protection, step-up authentication, and explicit audience and tenant binding. Samples in this paper illustrate control shape; they are not production security code.
Conformance tests
Schema bounds, permission denial, field leakage, bulk extraction, failure state, and audit completeness.
Policy tests
Purpose, jurisdiction, consent, risk tier, approval, revocation, and protected-feature transformations.
Security tests
Direct and indirect injection, privilege escalation, connector compromise, exfiltration, and trace redaction.
Governance tests
Vendor-change notices, model changes, subprocessors, deletion evidence, incident drills, and kill-switch timing.
Every agent action needs a verifiable chain of authority
A login proves that someone authenticated. It does not prove which human authorized an agent, which legal entity operates it, which runtime executed the call, or whether it could delegate the work again. RAILS therefore treats the human principal, brokerage, agent application, runtime workload, vendor, and downstream agent as distinct actors. No agent may collapse that chain into the realtor’s identity or pass the same bearer credential through multiple services.
Human principal
The licensed member or authorized assistant who grants authority and remains professionally accountable.
Accountable organization
The brokerage, board, MLS, or other legal entity whose policy and tenant boundary apply.
Agent client
The registered application receiving a narrow delegation—not the model name or a shared browser session.
Runtime workload
The specific production service instance or trusted execution identity that presents the credential.
Capability issuer
The authorization service that verifies entitlement, policy, consent, license status, and risk tier.
Downstream agent
A separately identified agent that receives a reduced, time-bound delegation for one task.
framework_version: rails/1.4
profile_schema: rails-delegation-profile/1.0
delegation_id: del_opaque
issuer: board_authorization_service
human_principal: realtor_opaque
accountable_organization: brokerage_opaque
agent_client: registered_app_opaque
runtime_workload: attested_workload_opaque
tenant: board_or_mls_opaque
audience: https://showing.example/capabilities
capabilities: [showing:availability_read, showing:request_create]
purpose: buyer_showing
jurisdiction_profile: ca-on/1.0
consent_ref: consent_opaque
parent_delegation: null
subdelegation: prohibited_by_default
issued_at: 2026-07-22T14:00:00Z
expires_at: 2026-07-22T14:10:00Z
proof: issuer_signature_and_sender_binding| Requirement | Normative RAILS rule |
|---|---|
| One hop, one token | Each downstream service receives a new audience-bound token through an approved exchange. Token passthrough is prohibited. |
| Sender constraint | High-risk capabilities use proof-of-possession or mutual-TLS credentials so a copied token is not sufficient. |
| Workload proof | The issuer verifies the registered client and runtime identity; a model-provided actor name is not identity evidence. |
| No silent sub-agents | Subdelegation is denied unless the parent grant names it. Child scope, purpose, data, time, and action ceilings can only decrease. |
| Continuous status | License, employment, consent, listing, client, device, and vendor-risk changes can revoke live authority before token expiry. |
| Step-up at consequence | A prior chat approval cannot authorize a materially different recipient, price, property, document, or physical-access event. |
This profile adopts the direction of the MCP authorization specification , which binds tokens to a target resource and forbids token passthrough, and the IETF’s OAuth token exchange and DPoP mechanisms. RAILS adds the real-estate principal, tenant, purpose, consent, license, jurisdiction, and subdelegation fields needed for professional accountability.
A showing is a stateful transaction—not a sequence of clicks
Agent-to-agent interoperability requires both sides to agree on what happened when a request pauses, conflicts, expires, retries, or partially succeeds. RAILS maps its real-estate lifecycle to the base task model in the Agent2Agent protocol and defines domain outcomes that generic agent protocols do not decide.
| State | Meaning | Permitted next states |
|---|---|---|
| submitted | Accepted with a stable task ID; no business commitment yet. | authorization_required, working, rejected, cancelled |
| authorization_required | A named human, seller, tenant, or system approval is missing. | working, rejected, expired, cancelled |
| working | The authoritative service is validating or applying the action. | completed, failed, cancelled, compensation_required |
| completed | The system of record committed the outcome and returned its immutable reference. | compensation_required only |
| rejected | Policy or an entitled decision-maker declined the request. | terminal; create a new task for a new proposal |
| failed | The action did not commit; the error declares whether a retry is safe. | working on safe retry, or terminal |
| expired | The approval, slot, credential, or deadline elapsed before commitment. | terminal; re-authorize a new task |
| cancelled | Cancellation committed before the underlying action became irreversible. | terminal or compensation_required |
| compensation_required | A committed side effect must be reversed or reconciled by an authoritative workflow. | compensated, failed |
| compensated | The reversal committed and both parties received the reconciled state. | terminal |
- Idempotency keys are scoped to the tenant, actor, capability, and normalized request; reusing one with different content fails closed.
- Every mutable resource carries a version or ETag. A stale reschedule, cancellation, offer, or instruction update returns a conflict instead of overwriting newer state.
- Retries declare whether the prior attempt committed, use bounded exponential backoff, and never turn a transport timeout into an assumed business failure.
- Push events and webhooks are signed, timestamped, replay-protected, ordered or explicitly sequence-numbered, and recoverable through authoritative status polling.
- Deadlines, approval expiry, slot holds, timezone, cancellation policy, and compensation ownership are machine-readable.
- The platform publishes a reconciliation operation so both agents can recover after partial delivery, disconnection, or webhook loss.
Property entry is a separate, higher-risk capability
A confirmed appointment establishes eligibility to request entry; it does not deliver entry authority to the model. Lockbox, alarm, occupancy, access-note, and door-event data remain outside prompt, memory, trace, screenshot, and browser-replay surfaces.
framework_version: rails/1.4
profile_schema: rails-property-access-profile/1.0
capability: showing.entry_instruction_redeem
requires:
appointment_state: confirmed
appointment_ref: exact
recipient: authenticated_entitled_human_or_bound_device
property: exact_listing_ref
time_window: just_in_time
step_up_authentication: required
delivery:
channel: outside_model_context
forwardable: false
reveal_to_agent_runtime: false
screenshot_and_log_capture: prohibited
controls:
one_appointment_one_credential: required
door_event_audit: required_when_supported
emergency_revoke: immediate
offline_fallback: board_approved_human_process
retention: access_metadata_onlySafety ceilings also apply to scale. Each tenant sets per-task and daily limits for bookings, cancellations, messages, signatures, exports, compute, and paid calls. Abnormal velocity, fan-out, repeated denials, resource exhaustion, and denial-of-wallet patterns pause the capability before a financial or operational limit is crossed.
A board must be able to reconstruct, revoke, and survive an agent action
An append-only log is useful but not sufficient. A certifiable event must be portable, tamper-evident, privacy-minimized, and understandable without access to the vendor’s internal prompt history. Evidence follows the business action across API, MCP, CLI, queue, webhook, and agent-to-agent boundaries.
{
"specversion": "rails-evidence/1.0",
"event_id": "evt_opaque",
"event_type": "showing.request.completed",
"occurred_at": "2026-07-22T14:04:12Z",
"trace_id": "w3c_trace_context",
"task_id": "task_opaque",
"tenant": "board_or_mls_opaque",
"human_principal": "realtor_opaque",
"accountable_organization": "brokerage_opaque",
"agent_client": "registered_app_opaque",
"runtime_workload": "attested_workload_opaque",
"capability": "showing.request_create",
"purpose": "buyer_showing",
"policy_version": "board-policy/4.2",
"delegation_id": "del_opaque",
"approval_ref": "approval_opaque",
"input_digest": "sha256:...",
"output_digest": "sha256:...",
"model_and_tool_versions": ["model:registered", "mcp:2.1"],
"authoritative_result_ref": "appointment_opaque",
"outcome": "completed",
"previous_event_digest": "sha256:...",
"issuer_signature": "jws:...",
"sensitive_payload_logged": false
}Evidence integrity
Sign or seal exported events, preserve ordering and clock provenance, protect verification keys, and test that altered or missing events are detectable.
Privacy and legal hold
Apply published retention classes and deletion rules, but suspend deletion for a valid legal hold. Preserve the minimum defensible record and record every hold release.
Subject access and correction
Support authorized export, access, correction, and provenance requests without exposing other clients, confidential instructions, credentials, or security signals.
Cross-vendor tracing
Propagate a common trace and task reference while keeping prompts and protected payloads out of general observability systems. Use stable semantic event names and versioned fields.
Continuous authorization, incident response, and change control
Short-lived credentials reduce exposure but do not solve a compromise that occurs during their lifetime. Issuers need a signed security-event channel for account disablement, license or employment change, consent withdrawal, device compromise, vendor suspension, and emergency property-access revocation. The OpenID Shared Signals Framework offers a standards-based model for continuously communicating such changes.
| Control | Required outcome |
|---|---|
| Material change gate | A new model family, tool or MCP schema, authorization path, subprocessor, retention behaviour, risk policy, or consequential prompt requires regression evidence before production promotion. |
| Recertification threshold | The profile declares which changes require notice, limited retesting, or full recertification. Emergency security fixes may deploy first but must preserve evidence and receive retrospective review. |
| Incident contract | Roles, severity definitions, 24/7 contacts, containment authority, evidence preservation, participant and regulator notification clocks, and board-to-vendor updates are agreed before launch. |
| Credential recovery | Compromised keys, tokens, clients, runtimes, and downstream agents can be isolated independently; rotation does not require disabling every member account. |
| Exit and portability | The vendor can export active tasks, approvals, evidence, retention state, and authoritative references in a documented format, then prove deletion without destroying records subject to hold. |
| Degraded operations | A tested human fallback handles urgent cancellations, access revocation, deadlines, and reconciliation during vendor, network, identity, or model outages. |
Consumers need notice, recourse, and a named accountable party
Capability controls protect systems. They do not by themselves protect a person who receives a wrong message, inaccessible recommendation, discriminatory outcome, missed deadline, or document they did not understand. RAILS adds a consumer-rights layer to every consequential profile.
Meaningful disclosure
Disclose material AI participation and the responsible brokerage or organization in plain language when an agent communicates, recommends, negotiates, or prepares a consequential artifact.
Reach a human
Provide a usable path to an authorized human before a deadline or irreversible action. An AI loop is not an escalation channel.
Correct and contest
Let affected people identify bad source data, correct permitted records, contest an automated result, and obtain a human explanation without retaliation or dark patterns.
Consent and withdrawal
Record what was authorized, by whom, for which purpose and duration; make withdrawal effective across active tasks, memory, retrieval stores, and downstream processors.
Responsibility must be allocated before failure
| Party | Minimum accountable controls | Evidence |
|---|---|---|
| Participant | Purpose, client authority, professional review, truthful inputs, protected-class boundaries, and timely escalation. | Approval and attestation records |
| Brokerage | Supervision, approved-use policy, vendor approval, training, insurance, incident ownership, and offboarding. | Supervisory and access records |
| Board or MLS | Data and capability rules, issuer policy, certification criteria, enforcement, appeals, and ecosystem revocation. | Policy and conformance registry |
| Application vendor | Secure design, tenant isolation, delegation enforcement, model and tool control, evidence, support, breach duties, and deletion. | Technical tests and operational logs |
| System of record | Authoritative state, data quality, idempotency, versioning, signing or booking integrity, and recovery. | Committed business records |
| Model or infrastructure provider | Contracted data use, subprocessors, security, availability, change notice, and incident cooperation. | Contract, attestations, and service evidence |
Contracts should assign incident investigation, consumer remediation, missed-deadline handling, defence, indemnity, cyber coverage, errors-and-omissions coverage, evidence production, and regulatory cooperation. A generic statement that every party remains responsible is not an allocation model.
Jurisdiction profiles—not one North American rule
The core standard remains technology-neutral, while signed jurisdiction profiles bind capabilities to locally reviewed rules. A profile identifies the applicable privacy, human-rights or fair-housing, electronic-signature, recording-consent, forms-licensing, agency, advertising, recordkeeping, anti-money-laundering, sanctions, and unauthorized- practice-of-law requirements. Canadian profiles should explicitly map applicable federal and provincial privacy rules and FINTRAC duties; United States profiles should map federal and state privacy, fair-housing, e-signature, recording, OFAC, licensing, brokerage, and forms rules.
jurisdiction_profile: ca-on/1.0
facts:
participant_license_jurisdiction: CA-ON
brokerage_jurisdiction: CA-ON
property_jurisdiction: CA-ON
consumer_residence: collected_only_if_required
communication_parties: [CA-ON]
instrument_type: offer_to_purchase
recording_or_transcription: false
decision:
allowed_capabilities: policy_engine_result
required_disclosures: policy_engine_result
required_human_roles: policy_engine_result
retention_and_hold: policy_engine_result
decision_source_version: counsel_approved_rulesetThis is a policy-routing structure, not legal advice. Counsel must approve each profile, legal claims must be re-verified, and the technical system must fail closed when the required jurisdiction or authority cannot be determined.
RAILS claims must be testable, versioned, and independently governed
The research paper explains the architecture. The standard package defines compliance. RAILS v1.4 therefore separates the framework version from independently versioned capability, delegation, task, property-access, evidence, jurisdiction, and test profiles. A prose-aligned product must not market itself as certified.
| Class | Scope | Claim boundary |
|---|---|---|
| C0 · Principles aligned | Architecture and policy review only. | May state alignment; may not claim technical conformance or certification. |
| C1 · Read-only | Search, retrieval, rendering, summarization, and analytics without persistent protected-data custody. | Named read profiles and test-pack version. |
| C2 · Drafting | Creates non-binding drafts or recommendations with exact-artifact human review. | Named drafting capability and system-of-record integration. |
| C3 · Consequential action | Messages, showing requests, document routing, publishing, and other external side effects. | Delegation, task, evidence, approval, revocation, and resilience profiles required. |
| C4 · Physical or binding boundary | Property access, signatures, financial commitments, and potentially binding instruments. | Jurisdiction, step-up, exact-version, access, legal review, and highest-assurance tests required. |
framework: rails/1.4
implementation: vendor_product_and_version
conformance_class: C3
profiles:
capability: rails-showing/1.0
delegation: rails-delegation-profile/1.0
task: rails-task-profile/1.0
evidence: rails-evidence/1.0
jurisdiction: ca-on/1.0
test_pack: rails-conformance/1.0.0
tested_build_digest: sha256:...
certifier: independent_or_board_approved
issued_at: 2026-07-22
expires_at: defined_by_certification_policy
limitations: machine_readable
evidence_url: public_verification_recordNormative specifications
Publish schemas, field semantics, MUST/SHOULD/MAY requirements, capability and purpose registries, error codes, state transitions, privacy rules, and backward-compatibility guarantees.
Positive and negative tests
Test valid workflows plus denial, stale state, replay, duplicate, injection, cross-tenant access, revoked authority, changed artifacts, webhook loss, partial failure, legal hold, and emergency shutdown.
Reference components
Provide a minimal authorization gateway, MCP adapter, A2A task mapper, evidence verifier, sample policy engine, and mock systems of record without prescribing a commercial vendor.
Certification operations
Define application, evidence review, penetration testing, surveillance, expiry, material-change notice, suspension, appeal, revocation, and public registry procedures.
Open change control
Maintain named editors, cross-sector working groups, public issues, decision records, security disclosure, extension review, deprecation windows, and conflict-of-interest rules.
Version and extension policy
Version the framework, schemas, registries, jurisdiction rules, and test packs independently. Unknown required extensions fail closed; optional extensions cannot bypass core controls.
The v1.4 standards package
- RAILS Delegation Profile: principal, workload, audience, purpose, subdelegation, token exchange, sender binding, and continuous revocation.
- RAILS Task Profile: lifecycle states, concurrency, idempotency, deadlines, signed events, retries, cancellation, reconciliation, and compensation.
- RAILS Property Access Profile: appointment-to-entry separation, just-in-time human delivery, device binding, emergency revocation, and access evidence.
- RAILS Evidence Profile: canonical event envelope, trace propagation, tamper evidence, privacy minimization, export, retention, correction, and legal hold.
- RAILS Conformance Kit: schemas, registries, test vectors, adversarial fixtures, reference adapters, certification classes, and public verification records.
- Accountability and Jurisdiction Annexes: consumer notice and recourse, responsibility allocation, contract controls, insurance evidence, and counsel-approved local rule profiles.
What the framework still needs to specify
The preceding sections set the architectural guardrails, policy language, and adoption path. Several practical layers remain underspecified. Boards, MLSs, and vendors that adopt RAILS early will need to fill these gaps before certification can be enforced consistently and before consequential workflows can be trusted at scale.
Schemas, certification, and accreditation mechanics
Capability manifests need a published schema, a conformance test suite, and a clear accreditation body or bodies. RAILS should not become a single-vendor seal. The goal is a portable, reviewable profile that a board’s technical, legal, privacy, and security reviewers can audit independently.
- Publish a JSON/YAML capability-manifest schema with typed fields for actor, purpose, data class, input/output bounds, retention class, and revocation.
- Require architecture diagrams, a field-level data inventory, model and subprocessor lists, retention matrices, and training-use commitments.
- Define re-certification triggers: model changes, subprocessor additions, scope expansions, incidents, or material policy updates.
- Make revocation immediate and granular so a board can disable one capability without disabling an entire vendor.
- Publish conformance tests for schema bounds, permission denial, field leakage, bulk extraction, and audit completeness.
vendor: example-cma-vendor
capability: cma.prepare
rails_profile: 1.0
evidence:
- architecture_diagram.pdf
- data_flow_diagram.pdf
- field_inventory.csv
- model_and_subprocessor_list.csv
- retention_matrix.csv
- training_use_commitment.pdf
- tenant_isolation_test_report.pdf
- oauth_scopes.yaml
- tool_schema.yaml
- red_team_results.pdf
- fair_housing_test_results.pdf
- incident_response_plan.pdf
- deletion_evidence.pdf
- sbom.json
- aibom.jsonLiability, insurance, and enforcement
The framework states that the model is not the accountable actor, but it does not yet map accountability onto errors-and-omissions coverage, vendor indemnification, or disciplinary enforcement. A realtor who signs an AI-prepared offer needs to know whether their E&O policy covers the AI’s mistake and whether the vendor stands behind its validation logic.
Enforcement should be described as a process: complaint intake, evidence preservation, capability suspension, notice, appeal, and public revocation where warranted. The audit trail described in Section 8 is what makes that process fair and fast.
Fair-housing proxies and consumer disclosure
Section 10 prohibits protected-class criteria, but it does not yet catalogue the proxies that commonly replace them. A request for a “family neighbourhood” or “good schools” can steer by household composition or ethnicity if the system lets those phrases pass through to ranking or ad targeting.
- Maintain a public catalogue of prohibited features and proxy features, with examples: school-quality-only filters, crime-rate steering, ‘family-friendly’ as a ranking signal, and inferred household composition.
- Reject or transform vague criteria into objective, legally appropriate housing attributes: budget, commute, property type, accessibility, lot size, transit, and proximity to named amenities.
- Log the objective criteria that include or exclude each result so the recommendation is auditable.
- Disclose to consumers when they are interacting with an AI, when they are being shown AI-generated content, and how to escalate to a licensed human.
- Test ad delivery and recommendation outputs for disparate impact before and after launch.
Consumer disclosure is not a footnote. If a buyer searches on an AI-powered portal and the model ranks or excludes communities, the consumer should see that the ranking is AI-generated, the criteria used, and a clear path to a human realtor.
Appraisal, valuation, and finance regulation
CMA preparation and market analysis sit close to appraisal and mortgage underwriting. RAILS needs explicit boundaries so that a governed CMA tool does not drift into unlicensed appraisal or automated underwriting advice. In the United States, appraisal independence rules and the appraisal standards regulated by USPAP and FIRREA create bright lines that an AI must not cross. In Canada, provincial appraisal legislation and lender requirements vary.
- Label every CMA or valuation support output as a realtor-prepared opinion, not an appraisal, and show the assumptions and data-as-of date.
- Prohibit the model from representing itself as an appraiser, automated valuation model, or lender underwriter.
- Keep mortgage pre-qualification, rate advice, and financing recommendations inside licensed mortgage channels.
- Document jurisdiction-specific review: USPAP/FIRREA in the U.S., provincial appraisal acts and lender rules in Canada, and local MLS valuation policies everywhere.
Accessibility, language access, and small-brokerage equity
Governance programs can become a tax on small brokerages and solo agents. If certification is expensive, integration is complex, and documentation is only in English, the framework will advantage well-resourced incumbents and lock out the long tail of the profession.
- Provide model policy clauses and certification checklists in plain language and, where possible, in the languages spoken in the board’s market.
- Offer a reference open-source capability gateway, conformance tests, and sample manifests so smaller vendors and self-managed brokerages can participate.
- Publish a small-brokerage cost model: minimum viable controls, phased adoption, and free or low-cost audit tooling.
- Require accessibility conformance (WCAG, AODA, ADA) for consumer-facing agentic interfaces and for the approval UX used by Realtors.
- Mandate data portability for audit logs, capability manifests, and member settings to reduce vendor lock-in.
Incident response, model evaluation, and RAG controls
Section 8 lists threats; Section 14 lists tests. The missing layer is the operational playbook: who is paged, what is preserved, how a capability is frozen, and how the board is notified. Long-term memory and retrieval-augmented generation also need their own controls.
- Maintain a runbook for suspected prompt injection, data exfiltration, tool misuse, model drift, and connector compromise.
- Define a kill switch that disables a capability or vendor without disabling the member’s core systems.
- Run recurring red-team exercises against the real capability surface, not just the chat interface.
- Benchmark models on real estate tasks under the RAILS harness; do not rely on generic leaderboards for consequential work.
- Isolate per-tenant retrieval indexes, set expiry and re-indexing rules, and prohibit protected data from entering shared vector stores.
trigger:
condition: unauthorized_extraction_detected
response:
- revoke_capability(capability_id, reason)
- preserve_audit_trail(trace_id)
- notify_security_team(tenant, actor, capability, timestamp)
- notify_board_liaison_within(policy.incident_sla)
- freeze_related_sessions(actor_id, capability_id)
- open_incident_record(reference: trace_id)Human-review UX and realtor training
A signature bound to a document hash is strong only if the licensee actually read and understood the instrument. Approval UX must make manipulation, fatigue, and click-through signing structurally difficult. Realtors also need training on what to verify when an AI prepares a CMA, offer, disclosure, or social post.
- Show the exact artifact, its provenance, and a diff against any earlier version at the approval moment.
- Require explicit confirmation of key facts: data-as-of date, comparable set, form version, parties, price, deposit, and conditions.
- Use step-up authentication for Tier 4 and Tier 5 actions so the approval is attributable.
- Publish a training module on AI-assisted review: how to spot hallucinated comparables, wrong form selection, and missing disclosures.
- Track human-review completion rates, override reasons, and error catches as operational metrics.
Governance is not finished when the policy is published. It is finished when the controls are testable, the liability is allocated, and the human checkpoint is designed so it cannot be skipped.
Organized real estate can govern the interface shift without surrendering the record
Consumers will choose convenient interfaces. Professionals will choose tools that save time. Portals and model providers will continue competing for the point at which intent becomes workflow. The durable response is not to pretend that shift can be stopped. It is to define the trust infrastructure through which it operates.
The useful boundary is custody versus capability; persistent storage versus controlled transient processing; autonomous action versus accountable approval; probabilistic explanation versus deterministic calculation; and ungoverned distribution versus auditable access.
Better interfaces should operate through board-defined trust—not around it.
Boards that define identity, permission, provenance, quality, interoperability, auditability, certification, and revocation can protect data while improving member capability. Boards that focus only on yesterday’s interface may preserve the feed while losing influence over tomorrow’s consumer journey.
Questions
Frequently asked questions about RAILS
What is the RAILS Framework?
RAILS, the Realtor Agentic Interoperability Layer Standard, is a proposed governance and technical architecture for agentic AI in real estate. It lets AI systems do useful member work through narrow, permissioned capabilities while custody of listing, client, and transaction data stays in board-approved systems of record.
What does capability without custody mean?
An AI system can be granted a bounded capability, such as running a permissioned listing search or preparing a CMA, without ever holding the underlying dataset, feed credentials, or authoritative record. Capability crosses the trust boundary. Custody does not.
Can an AI agent sign or send an offer under RAILS?
An AI may prepare and validate an offer, and it may invoke approved platform dispatch only after step-up authentication and human approval bound to the exact document version. It may never apply the realtor's or client's signature or send an unapproved instrument. A later mutation invalidates the approval.
Can two AI agents book a real estate showing under RAILS?
Yes, if both agents act through delegated, identity-bound capabilities exposed by the showing system of record. The buyer-side agent may read permitted availability and create an idempotent request; the listing-side service applies seller instructions and approval policy; and the platform returns a confirmation without exposing passwords, browser sessions, lockbox data, or confidential instructions to either model.
How does a realtor keep a human in the loop without losing the speed benefits?
By moving the checkpoint instead of removing it. In an early phase the AI proposes structured fields and an approved form service creates the draft for the realtor to review and move. In a later phase the approved transaction API creates and routes the exact version, but the realtor records an approval or professional attestation before the client sees it. The legal effect of any signature depends on the instrument, authority, and jurisdiction.
Is client or MLS data used to train the models?
RAILS prohibits using protected data to train, fine-tune, improve, or evaluate a model unless every party with the legal right to authorize that use has done so. The framework also treats retention as its own control surface, separate from training claims, across nine distinct places data can persist.
Who is RAILS for?
Boards, MLSs, brokerages, professional associations, regulators, and technology vendors that need a shared vocabulary of protected data domains, capability tiers, approval boundaries, certification evidence, and audit requirements for agentic AI.
What does RAILS-compliant mean?
A vendor should claim RAILS conformance only against a named profile version and conformance class, after passing the published positive and negative tests for identity, authorization, task state, data minimization, human approval, evidence, revocation, and failure handling. Marketing alignment with the principles alone is not certification.
Does booking a showing give an AI access to a property?
No. Appointment authority and physical-entry authority are separate capabilities. A confirmed booking may create eligibility for just-in-time instructions, but any lockbox, alarm, or entry credential must be delivered outside model context to an entitled human or bound device for one property, appointment, and time window.
Selected primary sources and standards
Product claims are factual only to the extent supported by the linked publisher. The RAILS architecture, tiers, policy language, and roadmap are proposals by the authors. Legal requirements vary and must be re-verified before adoption.
- 01
- 02
- 03
- 04
- 05
- 06
Model Context Protocol
Authorization specification (Nov. 25, 2025) - 07
Model Context Protocol
Security best practices and token-passthrough prohibition - 08
- 09
- 10
- 11
OpenID Foundation
Shared Signals and Continuous Access Evaluation - 12
- 13
- 14
- 15
- 16
- 17
OpenAI
ChatGPT Search - 18
Anthropic
Consumer data-use choices for Claude - 19
Anthropic
Enabling and using web search - 20
- 21
ShowingTime+
Real-Time Availability API for brokers - 22
- 23
- 24
Aligned Showings
Scheduling, approvals, calendars, messaging, and routing - 25
- 26
Instashowing
Showing-management workflow - 27
- 28
SkySlope
Transaction-management APIs - 29
SkySlope
Offers API reference - 30
- 31
- 32
dotloop
OAuth 2.0 public API - 33
Form Simplicity
Scoped transaction API - 34
DocuSign
Agreement and eSignature APIs - 35
- 36
Nano-PDF
Open-source AI PDF-editing CLI - 37
Follow Up Boss
REST API and webhook documentation - 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
CREA
REALTOR.ca DDF® - 47
OPC Canada
PIPEDA requirements in brief - 48
- 49