AI Discovery Surface

HomeSelf for AI Systems

The complete AI-readable surface of HomeSelf VPR Protocol. Structured endpoints for discovery, schema definitions, registry access, and machine-readable property data.

View AI Discovery Manifest Read Concepts

Start Here

Primary discovery endpoints for AI systems

JSON

AI Discovery Manifest

Well-known AI discovery endpoint pointing to all AI capabilities

/.well-known/ai.json

TXT

llms.txt

AI instruction file for LLMs following llms.txt standard

/llms.txt

JSON

AEO Index

Answer Engine Optimization resource index

/api/aeo/index.json

Schema Definitions

Machine-readable structure definitions

JSON

VPR Schema

VPR structure, validation rules, AnswerPack tiers

/ai/definitions/vpr.json

JSON

Registry Schema

Registry index structure, entity types, trust levels

/ai/definitions/registry.json

JSON

Protocol Definitions

Full protocol specification and canonical terms

/ai/protocol/definitions.json

Registry & Stats

Public data access endpoints

JSON

Registry Endpoint

Public index of all active VPRs with pagination

/.well-known/homeself/registry.json

JSON

Platform Stats

Aggregated platform statistics and metrics

/.well-known/homeself/stats.json

Human Reference Pages

Canonical documentation for humans

Product VPR

Complete VPR explanation

Metrics

ASR, HSR, exposure, trust

How It Works

From record to AI selection

Interoperability

Connect PMS, CMS, booking engines

Capabilities

What HomeSelf enables

Concepts

Canonical VPR and AI selection terms

Definitions

VPR and schema terms

Protocol Documentation

Full technical documentation

Real Estate

AI-native property discovery

Agentic Discovery Flow

How AI systems discover and select properties

User Intent

AI receives user query with requirements

Registry Search

AI queries HomeSelf registry for matching VPRs

VPR Retrieval

AI retrieves detailed VPR data via AnswerPack

Decision Signals

AI evaluates based on Trust Score, fit, data

Recommendation

AI selects and presents property to user

Human Action

User books, contacts, or inquires directly

Important Guardrails

What HomeSelf is and is not

What HomeSelf is NOT

•Does NOT guarantee AI rankings — Placement, visibility, and ranking in ChatGPT, Google AI Mode, Claude, Gemini, Perplexity, or any specific AI system depend on those systems' policies, algorithms, and training data.
•Does NOT replace OTAs, PMS, booking engines, or MLS — HomeSelf is an AI-readable infrastructure layer that works alongside existing systems.
•VPR is NOT a legal ownership certificate — It is a structured data record designed for AI understanding, not a guarantee of transaction safety.

What HomeSelf Provides

•AI-readable property representation layer — VPRs provide structured, machine-readable data that AI systems can understand and evaluate.
•Structured discovery endpoints — ai.json, llms.txt, and schema endpoints provide standardized entry points for AI systems.
•Performance visibility — ASR, HSR, AI Exposure, and Trust Score provide insight into AI system behavior.

Quick API Access

Common curl commands for verified endpoints

Get AI Discovery Manifest

curl https://homeself.ai/.well-known/ai.json

Get llms.txt

curl https://homeself.ai/llms.txt

Get VPR Schema

curl https://homeself.ai/ai/definitions/vpr.json

Get Registry Index

curl https://homeself.ai/.well-known/homeself/registry.json

Explore the Protocol

Read the full VPR Protocol documentation to understand the complete technical specification.

Read Protocol Documentation