Tarot Three Card Spread
asterwise_get_tarot_three_card_spread
Past / Present / Future spread. Draws 3 unique cards using cryptographic randomness and assigns each to a named positional slot with an interpretive context.
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. |
allow_reversed | boolean | no | Whether cards may be drawn reversed (upside down). |
question | string/null | no | The question being asked; it shapes the reading's interpretation. |
What it covers
The three-card spread is the most widely used tarot layout. Position 1 (past) shows what led to the current situation. Position 2 (present) shows current energy and the core issue. Position 3 (future) shows the likely outcome if current energy continues. Each card returns position, position_meaning, and active_meaning — the complete interpretive context is included; callers do not need external position tables.
Workflow
BEFORE: None — standalone reading.
AFTER: asterwise_get_tarot_celtic_cross — for deeper 10-position analysis of same question.
Input
allow_reversed (bool, default false) — Each card independently has 50% reversal chance.
question (optional string, max 500 chars) — The question being asked.
Setting a question is strongly recommended for coherent readings.
Example: 'What should I focus on in my career this month?'
The question is echoed in the response but does not affect card selection.
Output contract
data.spread_type (string — 'three_card')
data.positions[] — 3 objects in order [past, present, future]:
card — full card object
is_reversed (bool)
position (string — 'past'|'present'|'future')
position_meaning (string — what this position represents in the spread)
active_meaning (string — orientation-appropriate card interpretation)
active_keywords[] (string array)
data.question (string or null — echoed)
Response format
response_format=json — full spread object.
response_format=markdown — formatted three-card reading.
Compute class
FAST_LOOKUP — cryptographic randomness, no ephemeris.
Errors
INVALID_PARAMS (local): None.
INTERNAL_ERROR: Any upstream API failure → MCP INTERNAL_ERROR
Do not confuse with
asterwise_draw_tarot_cards — free draw with no positional meaning.
asterwise_get_tarot_celtic_cross — 10-card spread with comprehensive positional coverage.
asterwise_get_tarot_yes_no — single-card binary answer, no positional structure.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.