Tarot Card of the Day
asterwise_get_tarot_card_of_the_day
Returns a deterministic daily tarot card seeded by SHA-256 hash of the date string. The same card is returned for all callers on the same date — this is intentional. The daily card is not a reading for an individual but a collective daily energy.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
response_format | enum: markdown, json | no | Output format: 'markdown' (default) for a readable report, or 'json' for the raw structured payload. |
date | string/null | no | Date to get the card for, YYYY-MM-DD. Defaults to today's date in UTC, or in timezone. Overrides timezone. |
allow_reversed | boolean | no | Whether cards may be drawn reversed (upside down). |
timezone | string/null | no | IANA time zone (or ±HH:MM) whose current date counts as today, e.g. 'Asia/Kolkata'. Defaults to UTC; ignored when date is given. |
What it covers
Deterministic daily oracle: one card with its upright or reversed orientation (also deterministic when allow_reversed=true). The SHA-256 seed ensures that no two consecutive days produce the same card except by mathematical coincidence. The active_meaning field pre-computes the correct interpretation for the orientation — callers do not need to branch on is_reversed.
Workflow
BEFORE: None — standalone.
AFTER: asterwise_get_tarot_three_card_spread — for deeper daily reading context.
Input
date (optional string YYYY-MM-DD) — Date to get the card for. Defaults to today's date in UTC, or in timezone. Overrides timezone.
Example: '2026-05-01'
allow_reversed (optional bool) — Default: false.
When true: reversed state is also deterministic (seeded by date+'_rev').
When false: card is always upright regardless of date.
timezone (optional, IANA or ±HH:MM, e.g. 'Asia/Kolkata') — zone whose current date is today. Default: UTC.
Output contract
data.date (string — YYYY-MM-DD, the date this card represents)
data.timezone (string — zone whose current date was used; absent when date is given)
data.card — full card object (same shape as asterwise_get_tarot_card)
data.is_reversed (bool)
data.active_meaning (string — upright_meaning when not reversed, reversed_meaning when reversed)
data.active_keywords[] (string array — upright or reversed keywords per orientation)
Response format
response_format=json — full card object with metadata.
response_format=markdown — human-readable daily card report.
Compute class
FAST_LOOKUP — deterministic, no randomness.
Errors
INVALID_PARAMS (local): None — date is validated upstream.
INVALID_PARAMS (upstream): bad date or unknown timezone → 422 validation_error, surfaces as MCP INTERNAL_ERROR with the API message.
INTERNAL_ERROR: Any upstream API failure → MCP INTERNAL_ERROR
Do not confuse with
asterwise_draw_tarot_cards — random draw, different every call.
asterwise_get_tarot_three_card_spread — positional reading with question context.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.