Tarot Suit
asterwise_get_tarot_suit
Returns all 14 cards in a given Minor Arcana suit as a structured array.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
suit | string | yes | Minor arcana suit: wands, cups, swords or pentacles. |
response_format | enum: markdown, json | no | Output format: 'markdown' (default) for a readable report, or 'json' for the raw structured payload. |
What it covers
Each of the four suits has 14 cards: Ace through 10 plus Page, Knight, Queen, King. Elemental associations: Wands=fire (action, career, creativity), Cups=water (emotions, relationships, intuition), Swords=air (intellect, conflict, truth), Pentacles=earth (material, money, body, practical matters).
Workflow
BEFORE: None — standalone.
AFTER: None.
Input
suit — One of exactly: 'wands', 'cups', 'swords', 'pentacles'.
Case-insensitive. Any other value is rejected locally with MCP INVALID_PARAMS.
Output contract
data[] — 14 card objects for the requested suit, each identical to asterwise_get_tarot_card output. Ordered Ace through King.
Response format
response_format=json — array of 14 card objects.
response_format=markdown — formatted list.
Compute class
FAST_LOOKUP
Errors
INVALID_PARAMS (local):
— suit not in {wands, cups, swords, pentacles} → MCP INVALID_PARAMS immediately.
INTERNAL_ERROR: Any upstream API failure → MCP INTERNAL_ERROR
Do not confuse with
asterwise_get_tarot_major_arcana — 22 Major Arcana, not suit-based.
asterwise_get_tarot_cards — full 78-card catalogue.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.