Tarot Cards Catalogue
asterwise_get_tarot_cards
Returns the complete 78-card Rider-Waite-Smith deck with full metadata. Each card includes id (slug), name, arcana_type (major/minor), suit, number, element, astrology_correspondence, upright and reversed meanings, keywords for both orientations, yes/no polarity, and visual description.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
response_format | enum: markdown, json | no |
What it covers
The complete 78-card Rider-Waite-Smith deck as structured JSON. Every card includes both upright and reversed meanings as separate fields, making orientation-aware interpretation automatic — the caller does not need to branch on is_reversed. The visual description field describes the imagery of each card. Use this endpoint to populate card databases, build card browsers, filter by element or astrology correspondence, or batch-load the deck for offline use.
Workflow
BEFORE: None — standalone catalogue endpoint.
AFTER: asterwise_draw_tarot_cards or asterwise_get_tarot_three_card_spread — use card data from this endpoint to build enriched display layers.
Input
response_format — Required: markdown | json (same as all Asterwise tools).
No other parameters.
Output contract
data[] — 78 card objects, each:
id (slug e.g. 'the-fool', 'ace-of-wands')
name, arcana_type, suit (null for major arcana), number
element, astrology_correspondence
keywords_upright[], keywords_reversed[]
upright_meaning, reversed_meaning
yes_no ('yes'|'no'|'maybe'), description
Response format
response_format=json serialises the complete 78-card array as indented JSON.
response_format=markdown renders a structured human-readable card catalogue.
Both modes return identical underlying data.
Compute class
FAST_LOOKUP — data is static; no ephemeris or randomness involved.
Errors
INVALID_PARAMS (local): None — no input parameters beyond response_format.
INTERNAL_ERROR: Any upstream API failure → MCP INTERNAL_ERROR
Do not confuse with
asterwise_get_tarot_major_arcana — returns only the 22 Major Arcana subset.
asterwise_get_tarot_suit — returns only the 14 cards of a single suit.
asterwise_draw_tarot_cards — returns a random draw, not the catalogue.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.