AI Divination Skills — Claude Code MCP server: tarot, I Ching, Bazi
An MCP server that hands your agent audited scripts for tarot, I Ching, Xiao Liu Ren and Bazi. The model interprets the draw instead of making it up.
claude mcp add ai-divination-skills -- uvx ai-divination-skillsWhat AI Divination Skills does
AI Divination Skills wires four systems into an agent: tarot, I Ching, Xiao Liu Ren and Bazi (Four Pillars). A local script produces the draw, the hexagram or the position; the model receives that JSON and reads it. The split is the whole point — the result does not come from the model's text.
The scripts live at skills/tarot/scripts/draw.py, skills/iching/scripts/cast.py, skills/xiaoliuren/scripts/cast.py and skills/bazi/scripts/cast.py. Each one prints JSON with metadata that shows which method was used. Real readings pull from system randomness; seeded mode exists for tests and repeatable demos. Bazi needs the optional lunar-python extra, so that skill stays dark until you add it.
Approximate modes emit a warning rather than passing themselves off as the traditional method. None of this proves divination works. It is a stricter workflow for symbolic reasoning, and if you want the same result twice in a test you have to pass a seed yourself.
What it helps with
- get a tarot draw the model did not invent
- check an I Ching hexagram against the actual cast
- compute a Xiao Liu Ren position from numbers
- build a Bazi chart from a birth datetime
- reproduce a demo reading with a seed
Example prompts for the agent
- Draw three tarot cards with reversals and interpret them
- Cast an I Ching hexagram with the yarrow method and explain it
- Build a Bazi chart from this birth datetime
How to install AI Divination Skills
Platform CLI
claude mcp add ai-divination-skills -- uvx ai-divination-skillsuvx runs the command named after the package; if the README names another one, use uvx --from ai-divination-skills <command>
Platform CLI
codex mcp add ai-divination-skills -- uvx ai-divination-skillsuvx runs the command named after the package; if the README names another one, use uvx --from ai-divination-skills <command>
Config file
{
"mcpServers": {
"ai-divination-skills": {
"command": "uvx",
"args": [
"ai-divination-skills"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from ai-divination-skills <command>
Config file
{
"servers": {
"ai-divination-skills": {
"type": "stdio",
"command": "uvx",
"args": [
"ai-divination-skills"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from ai-divination-skills <command>
Platform CLI
gemini mcp add ai-divination-skills uvx ai-divination-skillsuvx runs the command named after the package; if the README names another one, use uvx --from ai-divination-skills <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about AI Divination Skills
How do I install AI Divination Skills in Claude Code?
Run claude mcp add ai-divination-skills -- uvx ai-divination-skills.
What does AI Divination Skills do?
It connects four divination systems to your agent and passes the generated result to the model for interpretation. The scripts do the casting; the model does not.
What does Bazi require?
The optional lunar-python extra. The other systems run without it.
