{
    "gateway": "EnFavori Agent Gateway",
    "version": "1.2",
    "access": "public_read_only",
    "purpose": "Deterministic access to EnFavori permanent entities, preference rankings, evidence, history, attribution-aware actions and change data.",
    "tools": [
        {
            "name": "search_entities",
            "description": "Search public permanent EnFavori entities by name, slug or UID.",
            "arguments": {
                "q": {
                    "type": "string",
                    "required": true
                },
                "entity_type": {
                    "type": "string",
                    "required": false
                },
                "limit": {
                    "type": "integer",
                    "required": false,
                    "default": 10,
                    "maximum": 20
                }
            }
        },
        {
            "name": "get_entity",
            "description": "Get one public permanent entity by UID.",
            "arguments": {
                "uid": {
                    "type": "string",
                    "required": true
                }
            }
        },
        {
            "name": "get_actions",
            "description": "Get user-confirmed, attribution-aware action handoffs for one public entity without executing a transaction.",
            "arguments": {
                "uid": {
                    "type": "string",
                    "required": true
                }
            }
        },
        {
            "name": "get_rankings",
            "description": "Get current organic ranking facts for one published list.",
            "arguments": {
                "selector": {
                    "type": "string",
                    "required": true,
                    "description": "List slug or permanent list UID."
                }
            }
        },
        {
            "name": "get_evidence",
            "description": "Get methodology, provenance and evidence for one published list.",
            "arguments": {
                "selector": {
                    "type": "string",
                    "required": true
                }
            }
        },
        {
            "name": "get_trends",
            "description": "Get historical ranking observations for one published list.",
            "arguments": {
                "selector": {
                    "type": "string",
                    "required": true
                }
            }
        },
        {
            "name": "compare_entities",
            "description": "Compare up to five public entities using factual Passport and preference evidence only.",
            "arguments": {
                "uids": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "required": true,
                    "maximum_items": 5
                }
            }
        },
        {
            "name": "get_changes",
            "description": "Read immutable ranking snapshot changes.",
            "arguments": {
                "since": {
                    "type": "string",
                    "required": false,
                    "format": "date-time"
                },
                "cursor": {
                    "type": "string",
                    "required": false
                },
                "limit": {
                    "type": "integer",
                    "required": false,
                    "default": 50,
                    "maximum": 100
                }
            }
        }
    ],
    "trust": {
        "ranking": "organic_preference_ranking_not_affected_by_payment_verification_or_sponsorship",
        "votes": "preference_interactions_not_star_ratings",
        "unique_voters": "not_exposed_until_reliably_measured",
        "personal_data": "not_exposed",
        "scores": "no_invented_ai_scores",
        "actions": "discovery_only_user_confirmation_required_no_autonomous_transaction",
        "action_attribution": "signed_handoff_source_surface_tracking_without_personal_identity",
        "handoff_is_conversion": false,
        "confirmed_conversion": "requires_independent_provider_or_transaction_evidence"
    }
}