Familiar Tarot

com.familiartarot/tarot

Documentation

Familiar Tarot — a Tarot MCP Server for Claude & your AI

A tarot MCP server that gives Claude, ChatGPT, and any MCP-compatible client a real tarot deck: a true shuffle, real card art, upright or reversed, across multiple decks — then you talk the cards through in chat. A reflective practice, not fortune-telling.

It's hosted — there is no repo to clone, no npm install, no build. You add one URL and your assistant gains the deck.

Website: https://familiartarot.com
Learn more: https://familiartarot.com/tarot-mcp
Server URL (hosted — no account, no API key): https://mcp.familiartarot.com/mcp · transport: streamable-http
Per-client setup guides: https://familiartarot.com/connect

This repository is the public manifest for the hosted Familiar Tarot MCP server. The server runs at mcp.familiartarot.com — see .well-known/mcp/server.json. Published to the official MCP registry as com.familiartarot/tarot.

Why a hosted tarot MCP

A language model can write a tarot reading, but it cannot shuffle — ask it for a card and it picks the way it picks the next word, sometimes by what you seem to want to hear. Familiar removes that: the card is drawn before it is read, from a real shuffle of all seventy-eight (uniform odds — every card a true 1-in-78, upright or reversed at even chance). What you reflect on is what the deck turned up.

Unlike the open-source tarot MCP projects you install and run yourself, Familiar is hosted and maintained — and it ships real card artwork and multiple decks (Rider–Waite–Smith and the public-domain Tarot de Marseille, free), which a text-only server can't give your assistant.

What it does

Draws real cards — a verifiable shuffle, not invented by the model.
Multiple decks, real card artwork, upright & reversed.
Classic spreads (Celtic Cross, Past–Present–Future, …), single-card pulls, and yes/no draws.
Reflective, second-person readings — reflection, not divination.

Connect

The server speaks streamable-http at:

https://mcp.familiartarot.com/mcp

No account or API key is required. Pick the path your client supports:

Clients that add a remote MCP server by URL

Claude (claude.ai / Claude Desktop → Settings → Connectors → Add custom connector), ChatGPT (developer mode → connectors), Le Chat, and Perplexity — paste the URL above. Step-by-step, per client: https://familiartarot.com/connect

Clients that speak stdio (Cursor, Windsurf, and older setups)

Bridge the hosted server with mcp-remote:

{
  "mcpServers": {
    "familiar-tarot": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.familiartarot.com/mcp"]
    }
  }
}

Example

Once connected, just ask in plain language — the deck is a tool your assistant reaches for, not a character it plays:

You: Draw three cards on whether to take the new job.

Claude: (calls draw_spread) — Past–Present–Future: Eight of Pentacles, The Star (reversed), Ace of Wands. You've been putting in real, careful work… (reads the cards that were actually drawn, then talks them through with you)

Tools

list_decks, browse_deck — explore the available tarot decks
shuffle, cut, draw — a real, verifiable draw
draw_spread, draw_situation — classic spreads and situational layouts
list_patterns — the available spreads and situations

Compatible clients

Any MCP client. Confirmed paths: Claude Desktop, Claude.ai, ChatGPT (developer mode), Cursor, Windsurf, Le Chat, Perplexity — and the official MCP registry / connector directories (Glama, PulseMCP, LobeHub).