# AstroWay Tarot

> AstroWay Tarot is a freemium MCP server for astrology. Tarot tools for AI agents: Rider-Waite-Smith, Marseille and Lenormand spreads. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $5 a month
- **Platforms:** API
- **Website:** https://api.astroway.info/en/examples/mcp/
- **MCP Registry name:** info.astroway/tarot
- **Categories:** astrology
- **Listing updated:** 2026-11-15

## About

This endpoint, at mcp.astroway.info/mcp/tarot, handles card draws and readings for three decks: Rider-Waite-Smith, Marseille and Lenormand. The registry entry lists spreads, draws, card pictures and spread readings. AstroWay's pricing page counts 66 tarot endpoints across those decks.

It is one themed slice of AstroWay's API, where every endpoint becomes an MCP tool with a fixed credit cost. Simple lookups cost around 10 credits, and AI-written narratives cost far more. The free tier is 10,000 credits a month; the Esoteric Pack at $9 a month raises that to 200,000 credits and also covers numerology, geomancy, runes, palmistry and I Ching.

A separate key with limited quota is recommended before handing one to an agent, so a looping agent cannot burn the whole monthly budget.

## Features

- **Three decks:** Rider-Waite-Smith, Marseille and Lenormand.
- **Spreads and draws:** Draw cards into defined spreads.
- **Card images:** Card pictures for display.
- **Spread readings:** Interpretations of a drawn spread.
- **Credit pricing:** Fixed cost per call.

## Good for

- Draw a three-card spread in a chat app
- Show card images in a daily-card widget
- Offer Lenormand readings in a bot
- Generate a written spread reading

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tarot https://mcp.astroway.info/mcp/tarot
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.astroway.info/mcp/tarot
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tarot": {
      "url": "https://mcp.astroway.info/mcp/tarot"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tarot": {
      "type": "http",
      "url": "https://mcp.astroway.info/mcp/tarot"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tarot": {
      "serverUrl": "https://mcp.astroway.info/mcp/tarot"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tarot": {
      "type": "http",
      "url": "https://mcp.astroway.info/mcp/tarot"
    }
  }
}
```

## FAQ

### Which decks are supported?

Rider-Waite-Smith, Marseille and Lenormand.

### How is it billed?

Each API endpoint costs a fixed number of credits. The free tier gives 10,000 credits a month with no card, and the pricing page lists Indie at $5 a month with 50,000 credits.

### Is it safe to give an agent my key?

The docs advise creating a separate key with limited quota, which is built in from Starter upward.

### How do I connect?

Use the hosted Streamable HTTP endpoint with an Authorization: Bearer header carrying your aw_test_ or aw_live_ key; an npm stdio package also exists.

### Is AstroWay Tarot free?

AstroWay Tarot has a free plan, with paid plans for more usage or features. Paid plans start at $5 a month.

### How do I add AstroWay Tarot to Claude Code?

Run this command in your terminal: claude mcp add --transport http tarot https://mcp.astroway.info/mcp/tarot

### What are the best alternatives to AstroWay Tarot?

The closest alternatives to AstroWay Tarot are Natal Chart Lab, VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic) and Céu Natal.

## Alternatives

- [Natal Chart Lab](https://ai-powered.com/mcp/natal-chart-lab): Natal Chart Lab is an open-source MCP server for astrology.
- [VedicDost: Vedic Astrology, Kundli & AI Astrologer](https://ai-powered.com/mcp/vedicdost-vedic-astrology-kundli-and-ai-astrologer): VedicDost: Vedic Astrology, Kundli & AI Astrologer is a free MCP server for astrology.
- [AstroLogics](https://ai-powered.com/mcp/astrologics): AstroLogics is a freemium MCP server for astrology.
- [GenesisCore Astrology (Western + Vedic)](https://ai-powered.com/mcp/genesiscore-astrology-western-vedic): GenesisCore Astrology (Western + Vedic) is a free MCP server for astrology.
- [Céu Natal](https://ai-powered.com/mcp/ceu-natal): Céu Natal is an open-source MCP server for astrology.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [Moon Phase Software](https://ai-powered.com/mcp/moon-phase-software): Moon Phase Software is a free MCP server for astrology.
- [Zodiac Compatibility](https://ai-powered.com/mcp/zodiac-compatibility): Zodiac Compatibility is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/astroway-tarot
