Tipping Rules

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['country', 'bill'], 'properties': {'bill': {'anyOf': [{'type': 'number'}, {'type': 'string'}], 'description': 'Bill amount in local currency units (positive number).'}, 'country': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Country slug or name for local tipping norms.'}, 'service': {'type': 'string', 'description': 'Service category. Prefer restaurant, bar, taxi, delivery, hotelStaff, or tourGuides.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'type': 'object', 'required': ['ok', 'country', 'slug', 'service', 'bill', 'currency', 'mode', 'tipPercent', 'tipAmount', 'total', 'recommendation', 'lastReviewed', 'canonicalUrl', 'calculatorUrl', 'methodologyUrl', 'source'], 'properties': {'ok': {'type': 'boolean', 'const': True, 'description': 'True when the tip was calculated.'}, 'bill': {'type': 'number', 'description': 'Bill amount in local currency units.', 'exclusiveMinimum': 0}, 'mode': {'enum': ['percent', 'round_up', 'zero'], 'type': 'string', 'description': 'Calculation mode applied for this service and destination.'}, 'slug': {'type': 'string', 'description': 'Country slug.'}, 'total': {'type': 'number', 'description': 'Bill plus suggested tip.'}, 'source': {'type': 'string', 'const': 'Tipping Rules', 'description': 'Attribution for downstream citations.'}, 'country': {'type': 'string', 'description': 'Display name of the destination.'}, 'service': {'type': 'string', 'description': 'Service category label used for the calculation.'}, 'currency': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'ISO currency code when known (e.g. EUR, USD).'}, 'tipAmount': {'type': 'number', 'description': 'Suggested tip amount in local currency units.'}, 'tipPercent': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Applied tip percent when mode is percent; null for round-up.'}, 'canonicalUrl': {'type': 'string', 'format': 'uri', 'description': 'Canonical country page URL.'}, 'lastReviewed': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'ISO date when guidance was last reviewed, when available.'}, 'calculatorUrl': {'type': 'string', 'format': 'uri', 'description': 'Deep link to the on-site calculator for this country.'}, 'methodologyUrl': {'type': 'string', 'format': 'uri', 'description': 'How Tipping Rules reviews and sources guidance.'}, 'recommendation': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Human-readable norm string for the selected service.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['ok', 'code', 'message'], 'properties': {'ok': {'type': 'boolean', 'const': False, 'description': 'False when the tool could not complete successfully.'}, 'code': {'type': 'string', 'description': 'Machine-readable error code (e.g. NOT_FOUND, VALIDATION, TIMEOUT).'}, 'message': {'type': 'string', 'description': 'Short, agent-safe error message.'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'description': 'Tip calculation result or a structured error.'}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['country'], 'properties': {'country': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Country slug (preferred) or country name, e.g. japan or Japan.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'type': 'object', 'required': ['ok', 'country', 'slug', 'status', 'summary', 'situations', 'lastReviewed', 'canonicalUrl', 'methodologyUrl', 'source'], 'properties': {'ok': {'type': 'boolean', 'const': True, 'description': 'True when country guidance was loaded.'}, 'slug': {'type': 'string', 'description': 'Country slug.'}, 'source': {'type': 'string', 'const': 'Tipping Rules', 'description': 'Attribution for downstream citations.'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Overall tipping expectation label, when available.'}, 'country': {'type': 'string', 'description': 'Display name of the destination.'}, 'summary': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Short editorial summary of local tipping norms.'}, 'situations': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'recommendation', 'expectation'], 'properties': {'service': {'type': 'string', 'description': 'Service category label (e.g. Restaurant, Taxi).'}, 'expectation': {'type': 'string', 'description': 'Overall tipping expectation context for the destination.'}, 'recommendation': {'type': 'string', 'description': 'Concise tipping recommendation for the service.'}}, 'additionalProperties': False}, 'description': 'Key service recommendations (up to 8).'}, 'canonicalUrl': {'type': 'string', 'format': 'uri', 'description': 'Canonical country page URL.'}, 'lastReviewed': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'ISO date when guidance was last reviewed, when available.'}, 'methodologyUrl': {'type': 'string', 'format': 'uri', 'description': 'How Tipping Rules reviews and sources guidance.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['ok', 'code', 'message'], 'properties': {'ok': {'type': 'boolean', 'const': False, 'description': 'False when the tool could not complete successfully.'}, 'code': {'type': 'string', 'description': 'Machine-readable error code (e.g. NOT_FOUND, VALIDATION, TIMEOUT).'}, 'message': {'type': 'string', 'description': 'Short, agent-safe error message.'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'description': 'Country tipping guidance or a structured error.'}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'Country name, alias, or region fragment to search.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'type': 'object', 'required': ['ok', 'query', 'count', 'results', 'methodologyUrl', 'source'], 'properties': {'ok': {'type': 'boolean', 'const': True, 'description': 'True when search completed successfully.'}, 'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Number of destinations returned (max 8).'}, 'query': {'type': 'string', 'description': 'Echo of the submitted search query.'}, 'source': {'type': 'string', 'const': 'Tipping Rules', 'description': 'Attribution for downstream citations.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'status', 'region', 'canonicalUrl'], 'properties': {'name': {'type': 'string', 'description': 'Display name of the destination.'}, 'slug': {'type': 'string', 'description': 'Country slug for follow-up tool calls.'}, 'region': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Region label from the catalog, when available.'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Tipping expectation label, when available.'}, 'canonicalUrl': {'type': 'string', 'format': 'uri', 'description': 'Canonical country page URL on tippingrules.com.'}}, 'additionalProperties': False}, 'description': 'Matching destinations ordered by relevance.'}, 'methodologyUrl': {'type': 'string', 'format': 'uri', 'description': 'How Tipping Rules reviews and sources guidance.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['ok', 'code', 'message'], 'properties': {'ok': {'type': 'boolean', 'const': False, 'description': 'False when the tool could not complete successfully.'}, 'code': {'type': 'string', 'description': 'Machine-readable error code (e.g. NOT_FOUND, VALIDATION, TIMEOUT).'}, 'message': {'type': 'string', 'description': 'Short, agent-safe error message.'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'description': 'Search results or a structured error.'}