`random_card`

Pack: tarot · Endpoint: https://gateway.pipeworx.io/tarot/mcp

Draw a single random tarot card with its upright and reversed meanings.

Example call

Arguments

{}

curl

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

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('random_card', {});

Response shape

Always returns: name, name_short, value, value_int, type, suit, meaning_up, meaning_rev, desc

Field	Type	Description
`name`	string	Full name of the tarot card
`name_short`	string	Short identifier for the card
`value`	string	Card value or number
`value_int`	number	Integer representation of card value
`type`	string	Card type (e.g. Major Arcana, Minor Arcana)
`suit`	string \| null	Suit of the card (null for Major Arcana)
`meaning_up`	string	Upright meaning of the card
`meaning_rev`	string	Reversed meaning of the card
`desc`	string	Detailed description of the card

Full JSON Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Full name of the tarot card"
    },
    "name_short": {
      "type": "string",
      "description": "Short identifier for the card"
    },
    "value": {
      "type": "string",
      "description": "Card value or number"
    },
    "value_int": {
      "type": "number",
      "description": "Integer representation of card value"
    },
    "type": {
      "type": "string",
      "description": "Card type (e.g. Major Arcana, Minor Arcana)"
    },
    "suit": {
      "type": [
        "string",
        "null"
      ],
      "description": "Suit of the card (null for Major Arcana)"
    },
    "meaning_up": {
      "type": "string",
      "description": "Upright meaning of the card"
    },
    "meaning_rev": {
      "type": "string",
      "description": "Reversed meaning of the card"
    },
    "desc": {
      "type": "string",
      "description": "Detailed description of the card"
    }
  },
  "required": [
    "name",
    "name_short",
    "value",
    "value_int",
    "type",
    "suit",
    "meaning_up",
    "meaning_rev",
    "desc"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "tarot": {
      "url": "https://gateway.pipeworx.io/tarot/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

random_card