{
  "schema_version": "realtorzip-ai-discovery-v1.1",
  "name": "RealtorZip",
  "canonical_origin": "https://realtorzip.com",
  "purpose": "Verified real-estate agent discovery, comparison, verification, ZIP-market context, and consent-based introductions.",
  "human_documentation": "https://realtorzip.com/ai-priority",
  "methodology": "https://realtorzip.com/methodology",
  "data_sources": "https://realtorzip.com/data-sources",
  "editorial_policy": "https://realtorzip.com/editorial-policy",
  "privacy": "https://realtorzip.com/privacy",
  "terms": "https://realtorzip.com/terms",
  "machine_surfaces": {
    "robots": "https://realtorzip.com/robots.txt",
    "sitemap": "https://realtorzip.com/sitemap.xml",
    "market_sitemap": "https://realtorzip.com/sitemaps/markets",
    "llms": "https://realtorzip.com/llms.txt",
    "llms_full": "https://realtorzip.com/llms-full.txt",
    "openapi": "https://pulse-ai-production-cdfe.up.railway.app/openapi.json",
    "ai_tool_manifest": "https://pulse-ai-production-cdfe.up.railway.app/v1/ai/tools",
    "agent_index": "https://pulse-ai-production-cdfe.up.railway.app/v1/agents",
    "agent_search": "https://pulse-ai-production-cdfe.up.railway.app/v1/agents/search",
    "market_intelligence_template": "https://pulse-ai-production-cdfe.up.railway.app/v1/markets/{postal_code}/intelligence"
  },
  "direct_ai_integrations": {
    "rest_tools": {
      "status": "implemented",
      "capabilities": [
        "find_agents",
        "compare_agents",
        "verify_agent",
        "request_introduction"
      ]
    },
    "mcp": {
      "status": "implementation_ready_deployment_required",
      "transport": "streamable_http",
      "recommended_endpoint": "https://mcp.realtorzip.com/mcp",
      "read_only_tools": [
        "find_verified_agents",
        "verify_agent",
        "compare_agents",
        "get_zip_market_intelligence"
      ]
    },
    "chatgpt_plugin_and_app_publication": {
      "status": "publisher_submission_required",
      "discovery_channel": "ChatGPT and Codex Plugins Directory",
      "underlying_app_protocol": "MCP with Apps SDK packaging where applicable"
    },
    "microsoft_mcp_certification": {
      "status": "publisher_submission_required"
    },
    "perplexity_publisher_partnership": {
      "status": "publisher_application_required"
    }
  },
  "visibility_measurement": {
    "openai_web_search": "implemented_opt_in",
    "perplexity_sonar": "implemented_opt_in",
    "consumer_ui_automation": false,
    "retained_evidence": [
      "surface",
      "model",
      "prompt",
      "answer_excerpt",
      "mention_state",
      "citations",
      "realtorzip_citation_state",
      "response_id",
      "observed_at"
    ]
  },
  "crawl_access": {
    "public_content_allowed": true,
    "private_paths_blocked": true,
    "explicit_user_agents": [
      "OAI-SearchBot",
      "ChatGPT-User",
      "PerplexityBot",
      "Claude-SearchBot",
      "Claude-User",
      "Googlebot",
      "Google-Extended",
      "Bingbot",
      "Applebot",
      "Applebot-Extended"
    ]
  },
  "matching_policy": {
    "paid_position_required_for_realtorzip_priority": true,
    "additional_position_quantity_increases_match_rank": false,
    "verified_fit_and_current_availability_required": true,
    "paid_participation_disclosed": true
  },
  "external_priority_policy": {
    "objective": "Increase the likelihood that verified participants are discovered, resolved, cited, and recommended by independent search and AI systems.",
    "methods": [
      "canonical identity and authority records",
      "structured data and machine-readable interfaces",
      "crawler and sitemap access",
      "change notification and freshness controls",
      "direct REST and MCP tool access",
      "citation and mention measurement",
      "separately labeled paid distribution where available"
    ],
    "organic_answer_control_claimed": false,
    "undisclosed_paid_ranking_claimed": false
  },
  "last_material_update": "2026-08-08"
}