Love Oracle — Tarot MCP server

Love Oracle Tarot Dataset & MCP Server

All 78 Rider–Waite–Smith tarot cards with love and relationship keywords in 22 languages, plus arcana, suit, element and yes/no polarity — as a JSON file and as an MCP server that runs offline over it. No signup, free to use commercially under CC BY 4.0.

curl -O https://www.loveoracle.app/dataset/love-tarot.json

MCP server

Three read-only tools, zero dependencies, zero network calls — everything is answered from the JSON file in this repository.

{
  "mcpServers": {
    "love-oracle-tarot": {
      "command": "npx",
      "args": ["-y", "love-oracle-tarot"]
    }
  }
}

Or from a clone — it needs nothing installed:

node server.js

Or in Docker:

docker build -t love-oracle-tarot . && docker run -i --rm love-oracle-tarot

Want the long-form interpretations too? They are not in the dataset and so are not served here. What a card says as someone's feelings, what it means about an ex, and the answers to the most-asked love questions live on the site — reachable through the hosted MCP server at https://www.loveoracle.app/api/mcp (Streamable HTTP, no auth), listed in the official registry as app.loveoracle/tarot.

Public tarot datasets exist. Every one we could find is English-only. This one carries 1,716 keyword pairs across en, es, pt, fr, de, it, nl, da, no, fi, pl, hu, tr, ru, ja, ko, zh, zh-TW, th, vi, id, hi — the part nobody wants to redo.

Shape

{
  "slug": "the-lovers",
  "name": "The Lovers",
  "arcana": "major",
  "number": 6,
  "suit": null,
  "element": null,
  "yes_no": { "upright": "yes", "reversed": "no" },
  "image": "https://www.loveoracle.app/deck/the-lovers.webp",
  "url": "https://www.loveoracle.app/cards/the-lovers",
  "love": {
    "en": { "name": "The Lovers", "upright": "deep union, a real choice of the heart",
            "reversed": "disharmony, misaligned values, avoidance of choice" },
    "ja": { "name": "恋人たち", "upright": "深い結びつき、心からの選択",
            "reversed": "不調和、ずれた価値観、選ぶことからの逃避" }
  }
}

jq '.cards[] | select(.slug=="the-lovers") | .love.es' love-tarot.json
jq -r '.cards[] | select(.yes_no.upright=="yes") | .slug' love-tarot.json   # the 43 "yes" cards

Two honest caveats

career-focused app will want different phrasing.

• These keywords are written for love and relationship questions, not general divination. A

been reviewed by native speakers**. Structure and coverage are reliable — zero missing rows, zero silent fallbacks to English. Idiom in Thai and Vietnamese may not be. Corrections welcome: open an issue or mail hello@loveoracle.app.

• The 21 non-English languages were machine-translated from the English source and have **not

Shortened. The full README is on GitHub.