tarot_shuffle

Pack: tarot · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/tarot_shuffle for the schema, then POST the same URL with its arguments for the data.

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 the session is reshuffled or expires (24h). Hosted only — a standalone/npm build returns session_supported:false.

Parameters

NameTypeRequiredDescription
session_idstringnoReshuffle this existing session instead of opening a new one.
seedstringnoDeterministic shuffle order. Omit for fresh randomness.

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":"tarot_shuffle","arguments":{}}}'

TypeScript (@pipeworx/sdk)

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

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

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the tarot pack
{
  "mcpServers": {
    "tarot": {
      "url": "https://gateway.pipeworx.io/tarot/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build October 22, 2026