# Tarot Spread API

> Tarot Spread API. Perform the classic three-card tarot spread revealing Past (what led to this situation), Present (current energy and circumstances), and

- Capability page: https://roxyapi.com/apis/tarot-spread-api
- Full domain: https://roxyapi.com/products/tarot-api
- OpenAPI spec: https://roxyapi.com/api/v2/tarot/openapi.json
- Remote MCP server: https://roxyapi.com/mcp/tarot

## Overview

Perform the classic three-card tarot spread revealing Past (what led to this situation), Present (current energy and circumstances), and Future (likely outcome if current path continues). The most popular beginner-friendly spread, perfect for quick insights, daily guidance, or exploring specific questions. Each position includes a drawn card with reversal state, keywords, full meaning, and position-specific interpretation. Returns a summary connecting all three cards. Ideal for tarot reading apps, decision-making tools, and personal growth platforms. Optionally provide a seed for reproducible readings.

## Endpoints

- `POST /api/v2/tarot/spreads/three-card` Three-Card Spread: Past, Present, Future
- `POST /api/v2/tarot/spreads/career` Career Spread (7 cards)
- `POST /api/v2/tarot/spreads/celtic-cross` Celtic Cross Spread (10 cards)
- `POST /api/v2/tarot/spreads/custom` Custom Spread Builder
- `POST /api/v2/tarot/spreads/love` Love Spread (5 cards)
- `POST /api/v2/tarot/draw` Draw random tarot cards with reproducible results

## Example request

```bash
curl -X POST "https://roxyapi.com/api/v2/tarot/spreads/three-card" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"What do I need to know about my career?","seed":"optional-seed"}'
```

## Example response

```json
{
  "spread": "string",
  "positions": [
    {
      "position": 0,
      "name": "string",
      "interpretation": "string",
      "card": {
        "id": "string",
        "name": "string",
        "arcana": "major",
        "position": 0,
        "reversed": true,
        "keywords": [
          "string"
        ],
        "meaning": "string",
        "imageUrl": "string"
      }
    }
  ]
}
```

## Remote MCP

Every endpoint is a callable tool on the Remote MCP server at https://roxyapi.com/mcp/tarot over Streamable HTTP. Tool name for `POST /tarot/spreads/three-card`: `post_tarot_spreads_three_card`. `tools/list` is free; `tools/call` bills the same as REST.

## FAQ

### What does the Tarot Spread API return?

Perform the classic three-card tarot spread revealing Past (what led to this situation), Present (current energy and circumstances), and Future (likely outcome if current path continues). Every response is structured JSON with documented fields, not free text, so you map it straight into your product.

### How do I authenticate with the Tarot Spread API?

Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.

### Does the Tarot Spread API support multiple languages?

Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.

### Is the Tarot Spread API available over Remote MCP for AI agents?

Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/tarot over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.

### How is the Tarot Spread API billed?

Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 12 domains, so the Tarot Spread API is included at no extra cost.

### What lang values does the Tarot Spread API accept?

The lang parameter accepts en, tr, de, es, hi, pt, fr, ru. Case-insensitive where it is a path value.

## Full reference

Fetch the OpenAPI spec at https://roxyapi.com/api/v2/tarot/openapi.json. Master agent manifest at https://roxyapi.com/llms.txt.