Nyan Parlor MCP Server: Tarot, I Ching & BaZi
English · 日本語 · 简体中文 · 繁體中文 · 한국어
Free, read-only Model Context Protocol server from Nyan Parlor, an AI fortune-telling parlor for tarot, I Ching and BaZi. It gives AI assistants real random tarot draws and I Ching casts instead of invented ones, plus tarot card meanings, hexagram texts, BaZi (Four Pillars) charts and the Chinese zodiac 2027 forecast.
No API key and no sign-up. Questions and birth details are not saved; the host keeps standard request logs.
Connect
Remote endpoint (Streamable HTTP):
https://www.tarotoper.com/mcp
Claude (desktop or web): Settings → Connectors → Add custom connector → paste https://www.tarotoper.com/mcp.
Cursor (~/.cursor/mcp.json) and other clients that accept a remote URL:
{
"mcpServers": {
"nyan-parlor": { "url": "https://www.tarotoper.com/mcp" }
}
}
Claude Code:
claude mcp add --transport http nyan-parlor https://www.tarotoper.com/mcp
Tools
| Tool | What it does |
|---|
draw_tarot_cards | Draws 1–10 distinct cards from a 78-card Rider–Waite–Smith deck (crypto-random, optional reversals, optional position names). |
get_tarot_card_meaning | Keywords, upright and reversed meaning, love, feelings, career and money readings, yes/no lean and advice for any card. |
cast_i_ching | Three-coin casting (six tosses), with changing lines and the relating hexagram. |
get_hexagram | Any of the 64 hexagrams by number, English name, Chinese character or pinyin (ambiguous pinyin returns the candidates): judgment, image, love, career, guidance and line texts. |
bazi_chart | BaZi / Four Pillars chart from birth date, optional time and IANA time zone: pillars with Ten Gods and hidden stems, Day Master, five elements, luck pillars, coming years. Year changes at the Start of Spring (Li Chun). Without a birth time it computes at local noon and warns when the date sits on a solar-term boundary. |
chinese_zodiac | Zodiac animal from a birth year or date (handles Lunar New Year vs. Start of Spring for January–February births) and the 2027 Year of the Fire Goat forecast for that sign. |
Every tool takes language: en (default) or ja. With ja, card and hexagram names, meanings, BaZi terms (日干・通変星・大運・空亡) and links come back in Japanese, matching tarotoper.com/ja. Japanese card names (「ソードの3」「恋人」) and hexagram names (「火山旅」) are accepted as input.
Every result links to the matching page on tarotoper.com so users can read further.
Example
"Draw three cards for: will my friendship recover after our fight?"
The assistant calls draw_tarot_cards (count: 3, positions Past / Present / Future), then get_tarot_card_meaning with topic: "feelings" for each card, and answers with the cards that were actually drawn.
ChatGPT / Codex plugin
plugin.json + mcp.json + skills/ at the repository root form a portable plugin package (server + reading skill) for the ChatGPT and Codex plugin directory.
Agent Skill
skills/nyan-parlor-tarot is an Agent Skill that teaches an assistant how to give a reading with these tools (choose the spread from the question, restate positions, answer first, don't flip on pushback, keep facts and guesses apart), with offline draw and I Ching scripts for use without the server.
About
Nyan Parlor is an AI fortune-telling parlor for tarot, I Ching and BaZi at tarotoper.com (日本語: tarotoper.com/ja). This repository holds the public parts of the integration: the plugin manifest, the MCP connection config and the reading skill. The hosted server is free to use; no key needed.
On the site itself, readings come from Geumeum, the parlor's AI tarot reader: plain-spoken and a little lazy-sounding, sharp about the situation but never at you, remembering your story across readings and telling you what you can do next. Tools connected to your own AI give it real cards and correct charts, but the reading is written in your AI's own voice. More about her: Who is Geumeum? (日本語: クムムってどんな占い師？).
Questions or problems: tarotoper.com/en/contact.
