Tarot

liveEntertainment

Tarot card data — draw random cards, search by keyword, and get card meanings

6tools
0msauth
free tier50 calls/day

Tools

random_card

Draws one random card from the Pipeworx original 78-card tarot deck (Rider–Waite–Smith tradition). Returns the card, its orientation (upright or reversed, a coin-flip unless disabled), the traditional

No parameters required.

▶Try it
draw_cardsrequired: count

Draws a spread of 1–78 random cards from the Pipeworx original tarot deck (Rider–Waite–Smith tradition), each with its own orientation and traditional meaning for that orientation.

Parameters
NameTypeDescription
countreqnumberNumber of cards to draw (1-78)
▶Try it
search_cardsrequired: query

Searches the Pipeworx original tarot deck by name, suit, or keyword — matches against card names, both orientations’ keywords and meanings, and suit.

Parameters
NameTypeDescription
queryreqstringSearch keyword
▶Try it
get_cardrequired: name_short

Looks up one card from the Pipeworx original tarot deck by its id (e.g. "major_00", "wands_01") or its exact name (e.g. "The Fool"). Returns both upright and reversed meanings as reference, plus keywo

Parameters
NameTypeDescription
name_shortreqstringCard short name (e.g. ar01)
▶Try it
tarot_spread

Deals a named layout from the Pipeworx original tarot deck (Rider–Waite–Smith tradition): three_card, situation_obstacle_advice, celtic_cross, horseshoe, yes_no, or a custom set of positions. Each pos

No parameters required.

▶Try it
tarot_shuffle

Opens (or reshuffles) a stateful 78-card tarot session on the Pipeworx original deck, so later random_card/draw_cards/tarot_spread calls with the same session_id draw without repeating a card until th

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/tarot/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/tarot/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"random_card","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("random_card", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("tarot card data — draw random cards, search by keyword, and get card meanings");