Tarot Card Lookup
asterwise_get_tarot_card
Returns full structured data for a single card identified by its slug ID. Useful for card detail pages, single-card lookups, and displaying a specific card after the user selects one by name.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
card_id | string | yes | Tarot card identifier in kebab-case, e.g. 'the-fool' or 'ace-of-wands'. |
response_format | enum: markdown, json | no | Output format: 'markdown' (default) for a readable report, or 'json' for the raw structured payload. |
What it covers
Returns one card object from the 78-card Rider-Waite-Smith deck. The slug is the card's unique identifier in lowercase-hyphenated format. All fields are identical to what asterwise_get_tarot_cards returns per card.
Workflow
BEFORE: None — standalone.
AFTER: None.
Input
card_id — Slug identifier for the card. Must be exact.
Major Arcana examples: 'the-fool', 'the-magician', 'the-high-priestess', 'the-empress', 'the-emperor', 'the-hierophant', 'the-lovers', 'the-chariot', 'strength', 'the-hermit', 'wheel-of-fortune', 'justice', 'the-hanged-man', 'death', 'temperance', 'the-devil', 'the-tower', 'the-star', 'the-moon', 'the-sun', 'judgement', 'the-world'
Minor Arcana pattern: '{rank}-of-{suit}'
Examples: 'ace-of-wands', 'two-of-cups', 'ten-of-swords', 'page-of-pentacles', 'knight-of-wands', 'queen-of-cups', 'king-of-swords'
Output contract
data — single card object:
id (string — slug), name (string), arcana_type ('major'|'minor'), suit (string|null)
number (int — 0=Fool, 1–21=Major; 1=Ace, 11=Page, 12=Knight, 13=Queen, 14=King)
element (string), astrology_correspondence (string)
keywords_upright[] (string array), keywords_reversed[] (string array)
upright_meaning (string), reversed_meaning (string)
yes_no ('yes'|'no'|'maybe'), description (string — visual imagery)
Response format
response_format=json — single card object as JSON.
response_format=markdown — human-readable card detail.
Compute class
FAST_LOOKUP
Errors
INVALID_PARAMS (local): None.
INTERNAL_ERROR: Unknown card_id returns 404 upstream → MCP INTERNAL_ERROR
If the card is not found, check slug format: lowercase, hyphens, no spaces.
Do not confuse with
asterwise_get_tarot_cards — returns all 78 cards in one call.
asterwise_draw_tarot_cards — random draw, not a specific card.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.