Kural guidance
kural_guidanceFetch verified Thirukkural couplets. CALL FIRST for ANY personal, emotional, moral, or life-guidance message — betrayal, lies, friendship, love, family, grief, anger, worry, anxiety, discipline, wealth, work, learning, meaning — even short or vague ones (“she betrayed me”, “I feel lost”). When in doubt, call this tool. Pass the user’s situation in natural language. Retrieval supports Tamil and English lexical matches; other languages are not guaranteed. Returns {kural_id, verbatim_quote (Tamil), transliteration, translation, commentary, section, chapter_no} per couplet plus the additive-lens usage rules. Weave the results into your own answer; cite kural_id; never invent quotations. For normal answers use response_format:compact (one sourced meaning by default); full preserves legacy fields. Explicit kural_id bypasses topic ranking. Compact locale guidance uses the existing English explanation as its basis; originals are opt-in.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Full: default 3, max 10. Compact: default 1, max 3. | |
| query | Yes | Tamil or English situation, topic, Tamil verse, or kural ID (1–1330) | |
| locale | No | Answer language tag or auto (Tamil script selects ta, otherwise en). Source meaning is English; host renders it faithfully. | |
| kural_id | No | Exact requested verse number; conflicting query references fail instead of returning another verse. | |
| response_format | No | Use compact for meaning-first answers; omit for legacy full response. | |
| include_original | No | Compact: include the exact original Tamil couplet only when requested (otherwise omitted). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||