Nyan Parlor MCP Server

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

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.