Draw Tarot Cards
draw_cardsRead-only
Shuffle a full 78-card Rider-Waite-Smith deck with server-side randomness and show it face-down in an interactive widget, where the user picks their cards by hand. Where the widget renders, the tool result does not contain the drawn cards: the widget sends the cards the user picked to the conversation once the last one is revealed. In a text-only host the cards are drawn server-side and returned in the result. Takes a spread_id from list_spreads to draw into that spread's positions, or a card_count (1-10) for a free-form draw such as a single card of the day. Card names, position names and the widget text follow locale.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| locale | No | Language for spread names, position names, card names and widget text: the language the user is writing in, as a BCP-47 code (zh-CN = Simplified Chinese, zh-TW = Traditional Chinese). Defaults to en. | |
| spread_id | No | Spread id from list_spreads. Takes precedence over card_count. | |
| card_count | No | Number of cards for a free-form draw without a spread. Defaults to 3. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cards | No | ||
| spread | No | ||
| status | Yes | ||
| card_count | Yes |