{
  "markdown": "# Love Oracle Tarot Dataset & MCP Server\n\nAll 78 Rider–Waite–Smith tarot cards with **love and relationship keywords in 22 languages**, plus\narcana, suit, element and yes/no polarity — as a JSON file **and** as an MCP server that runs\noffline over it. No signup, free to use commercially under\n[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).\n\n```\ncurl -O https://www.loveoracle.app/dataset/love-tarot.json\n```\n\n## MCP server\n\nThree read-only tools, zero dependencies, zero network calls — everything is answered from the JSON\nfile in this repository.\n\n| Tool | What it does |\n|---|---|\n| `search_tarot_cards` | Find cards by name in any of the 22 languages; returns the slugs the other tools take |\n| `get_tarot_card_love_meaning` | One card: upright, reversed, yes/no leaning, arcana, suit, element |\n| `draw_tarot_cards` | Draw 1–10 cards without replacement, each ~30% likely to land reversed, with their love meanings |\n\n```json\n{\n  \"mcpServers\": {\n    \"love-oracle-tarot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"love-oracle-tarot\"]\n    }\n  }\n}\n```\n\nOr from a clone — it needs nothing installed:\n\n```bash\nnode server.js\n```\n\nOr in Docker:\n\n```bash\ndocker build -t love-oracle-tarot . && docker run -i --rm love-oracle-tarot\n```\n\n**Want the long-form interpretations too?** They are not in the dataset and so are not served here.\nWhat a card says as someone's feelings, what it means about an ex, and the answers to the\nmost-asked love questions live on the site — reachable through the hosted MCP server at\n`https://www.loveoracle.app/api/mcp` (Streamable HTTP, no auth), listed in the official registry as\n[`app.loveoracle/tarot`](https://registry.modelcontextprotocol.io/v0.1/servers?search=app.loveoracle/tarot).\n\nPublic tarot datasets exist. Every one we could find is English-only. This one carries\n**1,716 keyword pairs** across `en, es, pt, fr, de, it, nl, da, no, fi, pl, hu, tr, ru, ja, ko, zh,\nzh-TW, th, vi, id, hi` — the part nobody wants to redo.\n\n## Shape\n\n```json\n{\n  \"slug\": \"the-lovers\",\n  \"name\": \"The Lovers\",\n  \"arcana\": \"major\",\n  \"number\": 6,\n  \"suit\": null,\n  \"element\": null,\n  \"yes_no\": { \"upright\": \"yes\", \"reversed\": \"no\" },\n  \"image\": \"https://www.loveoracle.app/deck/the-lovers.webp\",\n  \"url\": \"https://www.loveoracle.app/cards/the-lovers\",\n  \"love\": {\n    \"en\": { \"name\": \"The Lovers\", \"upright\": \"deep union, a real choice of the heart\",\n            \"reversed\": \"disharmony, misaligned values, avoidance of choice\" },\n    \"ja\": { \"name\": \"恋人たち\", \"upright\": \"深い結びつき、心からの選択\",\n            \"reversed\": \"不調和、ずれた価値観、選ぶことからの逃避\" }\n  }\n}\n```\n\n| Field | Notes |\n|---|---|\n| `slug` | Stable identifier, always the English name. Never changes. Use it as your key |\n| `arcana` / `number` / `suit` | `major` 0–21, `minor` 1–14 (11 Page, 12 Knight, 13 Queen, 14 King) |\n| `element` | Suits only — `water`, `fire`, `air`, `earth`. **`null` for every major**, deliberately: their elemental attributions differ between the Golden Dawn, Marseille and modern schools, and we would rather leave a field empty than state a contested one as fact |\n| `yes_no` | Polarity for a one-card yes/no draw. Reversing a card flips it |\n| `image` | The 1909 scan. Public domain worldwide, no condition attached |\n| `love.<lang>` | Localized card name plus upright and reversed keywords |\n\n```bash\njq '.cards[] | select(.slug==\"the-lovers\") | .love.es' love-tarot.json\njq -r '.cards[] | select(.yes_no.upright==\"yes\") | .slug' love-tarot.json   # the 43 \"yes\" cards\n```\n\n## Two honest caveats\n\n- **These keywords are written for love and relationship questions**, not general divination. A\n  career-focused app will want different phrasing.\n- **The 21 non-English languages were machine-translated** from the English source and have **not\n  been reviewed by native speakers**. Structure and coverage are reliable — zero missing rows, zero\n  silent fallbacks to English. Idiom in Thai and Vietnamese may not be. Corrections welcome:\n  open an issue or mail hello@loveoracle.app.\n\n## Licence\n\n[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). Use it commercially, modify it, ship it.\nThe one condition is credit:\n\n```\nTarot data from Love Oracle — https://www.loveoracle.app\nCC BY 4.0\n```\n\nCard artwork is Pamela Colman Smith's 1909 edition, public domain worldwide, and carries no\ncondition at all.\n\n## Also available\n\n- **Canonical file, always current:** https://www.loveoracle.app/dataset/love-tarot.json\n- **Documentation:** https://www.loveoracle.app/dataset\n- **MCP server** (Streamable HTTP, read-only, no auth): `https://www.loveoracle.app/api/mcp` —\n  three tools: `search_tarot_cards`, `get_tarot_card_love_meaning`, `get_love_question_answer`\n- **Markdown:** every public page answers to `Accept: text/markdown`, or fetch `/md/<path>` directly\n\n```bash\ncurl -H \"Accept: text/markdown\" https://www.loveoracle.app/cards/the-lovers\ncurl https://www.loveoracle.app/md/es/cards/the-lovers\n```\n\n## What is not in here\n\nThe long-form interpretations — what each card means as someone's feelings, what it says about an\nex, the FAQs — stay on the card pages. This repository is the compact factual layer.\n\n---\n\nMaintained alongside [Love Oracle](https://www.loveoracle.app), an AI tarot reader for love\nquestions. If you build something with this, we would like to see it.\n",
  "bytes": 5303,
  "sha": "6cff2edf97d4c4734140579e08449a27c0eb28596d3a6112fd9afca7a5e00536",
  "repo_slug": "misko4b/love-oracle-tarot-dataset",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_app_loveoracle_tarot_74f072ad/readme"
}