Familiar Tarot Server

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).

Links

• Home — https://familiartarot.com
• What is a tarot MCP — https://familiartarot.com/tarot-mcp
• Reading tarot with Claude — https://familiartarot.com/claude-tarot-reading
• Cards & meanings — https://familiartarot.com/cards
• Spreads — https://familiartarot.com/spreads
• Support — [email protected]

---

Familiar is a reflective tarot practice for AI assistants. It does not predict the future; it offers a structured way to think with the cards.