{
    "service": "EnFavori AI Data Gateway",
    "discovery_version": "1.0",
    "api_version": "1.0",
    "access": "public_read_only",
    "authentication": "none",
    "api_base": "https://ai.enfavori.com/v1",
    "openapi": "https://ai.enfavori.com/v1/openapi.json",
    "documentation": "https://ai.enfavori.com/v1/docs",
    "catalog": "https://ai.enfavori.com/v1/catalog",
    "changes": "https://ai.enfavori.com/v1/changes",
    "legacy_machine_gateway": "https://ai.enfavori.com",
    "capabilities": [
        "published_rankings",
        "permanent_entity_ids",
        "preference_graph",
        "ranking_history",
        "provenance",
        "sha256_evidence",
        "change_feed",
        "etag_revalidation",
        "health_status",
        "freshness_signals",
        "crawler_policy",
        "business_passport",
        "entity_verification",
        "factual_profile_completeness",
        "action_discovery",
        "canonical_action_layer",
        "conversion_attribution",
        "source_surface_attribution",
        "agent_gateway",
        "mcp_tools",
        "agent_tool_discovery",
        "agent_entity_search",
        "agent_entity_lookup",
        "agent_action_discovery",
        "agent_rankings",
        "agent_evidence",
        "agent_trends",
        "agent_entity_comparison",
        "agent_change_feed",
        "commercial_api",
        "commercial_preference_insights"
    ],
    "semantics": {
        "votes": "preference_interactions_not_star_ratings",
        "unique_voters": "not_exposed_until_reliably_measured",
        "ranking": "net_score_desc_v1"
    },
    "status": "https://ai.enfavori.com/v1/status",
    "robots": "https://ai.enfavori.com/robots.txt",
    "business_passport": "https://ai.enfavori.com/v1/passports/{entity-uid}",
    "action_layer": {
        "version": "1.0",
        "endpoint": "https://ai.enfavori.com/v1/actions/{entity-uid}",
        "types": [
            "call",
            "whatsapp",
            "website",
            "get_quote",
            "reservation",
            "buy",
            "affiliate",
            "hotel_booking"
        ],
        "user_confirmation_required": true,
        "autonomous_transaction_execution": false,
        "attribution_handoff": true,
        "ranking_effect": "none"
    },
    "conversion_attribution": {
        "version": "1.1",
        "event_store": "ai_conversion_attribution_events",
        "handoff_event": "action_handoff",
        "handoff_is_conversion": false,
        "confirmed_conversion_requires": "independent_provider_or_transaction_evidence",
        "source_surfaces": [
            "api",
            "agent",
            "mcp",
            "web",
            "passport"
        ],
        "personal_identity_stored": false,
        "ranking_effect": "none"
    },
    "mcp": {
        "endpoint": "https://ai.enfavori.com/mcp",
        "protocol_version": "2026-07-28",
        "server_version": "1.1.0",
        "transport": "streamable_http_stateless",
        "methods": [
            "server/discover",
            "tools/list",
            "tools/call"
        ],
        "access": "public_read_only"
    },
    "crawler_policy": {
        "version": "1.0",
        "robots_url": "https://ai.enfavori.com/robots.txt",
        "search_discovery": {
            "oai_searchbot": "allowed"
        },
        "model_training": {
            "gptbot": "disallowed",
            "policy": "managed_separately_from_search_discovery"
        },
        "edge_access": "must_be_verified_at_cdn_waf_layer"
    },
    "production_readiness_version": "1.2",
    "business_passport_semantics": {
        "passport_existence": "does_not_imply_verified_business",
        "verification": "only_dedicated_current_entity_verification_can_set_verified_business_true",
        "publisher_payment_sponsor_state": "does_not_create_entity_verification",
        "profile_completeness": "not_an_ai_visibility_score",
        "actions": "public_action_discovery_only",
        "ranking": "organic_preference_ranking_not_affected_by_passport_verification_or_payment"
    },
    "action_layer_semantics": {
        "execution": "safe_attributed_handoff_only",
        "user_confirmation": "required",
        "autonomous_purchase_or_booking": "not_performed",
        "affiliate_declaration": "only_from_first_party_provider_or_link_metadata",
        "handoff_is_conversion": false,
        "personal_data": "not_exposed",
        "ranking_effect": "none"
    },
    "conversion_attribution_semantics": {
        "action_handoff": "attributed_intent_not_confirmed_sale_or_booking",
        "confirmed_conversion": "requires_independent_provider_or_transaction_evidence",
        "source_surface": "api_agent_mcp_web_or_passport",
        "personal_identity": "not_stored",
        "external_reference": "hashed_when_supplied",
        "ranking_effect": "none"
    },
    "mcp_semantics": {
        "tool_logic": "delegates_to_enfavori_agent_gateway",
        "write_operations": "none",
        "personal_data": "not_exposed",
        "action_attribution_surface": "mcp",
        "handoff_is_conversion": false,
        "ranking_effect": "none",
        "ai_score": "not_generated"
    },
    "agent_gateway": "https://ai.enfavori.com/v1/agent",
    "agent_tools": "https://ai.enfavori.com/v1/agent/tools",
    "agent_actions": "https://ai.enfavori.com/v1/agent/actions/{entity-uid}",
    "agent_gateway_version": "1.2",
    "agent_gateway_semantics": {
        "access": "public_read_only",
        "llm_execution": false,
        "deterministic_data_access": true,
        "actions": "user_confirmed_handoff_only",
        "autonomous_transactions": false,
        "personal_data": "not_exposed",
        "organic_ranking_effect": "none",
        "ai_scores": "not_invented"
    },
    "commercial_api": {
        "version": "1.0",
        "base": "https://ai.enfavori.com/v1/commercial/insights",
        "access": "authenticated_read_only",
        "authentication": "bearer_api_key",
        "scope": "insights.read",
        "endpoints": {
            "overview": "https://ai.enfavori.com/v1/commercial/insights/overview",
            "momentum": "https://ai.enfavori.com/v1/commercial/insights/momentum",
            "segments": "https://ai.enfavori.com/v1/commercial/insights/segments",
            "list_trend": "https://ai.enfavori.com/v1/commercial/insights/lists/{selector}"
        },
        "semantics": {
            "data": "aggregate_preference_intelligence_from_observed_snapshots",
            "momentum": "historical_observation_not_prediction",
            "personal_data": "not_exposed",
            "individual_voter_identity": "not_exposed",
            "ai_score": "not_generated",
            "ranking_effect_from_payment_or_access": "none"
        }
    }
}