Skip to main content

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

ParameterTypeRequiredDescription
response_formatenum: markdown, jsonno
allow_reversedbooleanno
questionstring/nullno

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.