Skip to main content
Glama
nyan-parlor

Nyan Parlor MCP Server

by nyan-parlor

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

Related MCP server: 命盘 Mingpan

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.

Questions or problems: tarotoper.com/en/contact.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Enables AI tools to perform Chinese fortune-telling analysis including Ziwei Doushu (Purple Star Astrology) and Bazi (Four Pillars) chart generation, fortune reading, and element analysis. Supports multiple calendar systems and output formats for comprehensive divination services.
    7
    7 npm
    6
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Provides traditional Chinese astrology (Bazi, Ziwei) and divination (Liuyao, Meihua, Qimen, etc.) calculations as MCP tools for AI assistants.
    18
    103 npm
    122
    Apache 2.0
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI agents to cast deterministic BaZi, Zi Wei Dou Shu, and Western astrology natal charts from birth details, with no setup or API key.
    1
    22 npm
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Provides stateless tools for calculating BaZi charts, casting I Ching hexagrams, drawing tarot cards, and generating Zi Wei twelve-palace charts. Agents can call these tools without an account or model key and interpret the structured results with their own model.
    MIT