PattrickChenforclaudeuse/mythsensus-mcp

> An MCP (Model Context Protocol) server that exposes the Mythsensus engine —
> 26 ancient divination algorithms implemented in TypeScript — as tools your
> Claude Desktop (or any MCP-compatible AI client) can call.
What this is (and isn't)
**This is** a Model Context Protocol server that bundles the compiled Mythsensus
engine (1.1 MB JavaScript, plus a 2.8 MB deity encyclopedia) and exposes 7 tools
Claude can invoke. Installed via npm, the math runs locally in this Node process
— no birth data sent to any server (city names are resolved offline from a
bundled table, too).
**This is not** an LLM wrapper. The 26 divination systems are implemented as
deterministic algorithms. Same input, same output, every time. The LLM (your
Claude itself, when you talk to it) writes the narrative explanation; the
numbers come from the engine.
**Not affiliated with Anthropic.** Built independently using Anthropic's
public MCP SDK.
Install
Option A — hosted, nothing to install
The same server runs at https://mythsensus.com/mcp over streamable HTTP, so a
client can connect without npm, Node, or a local process:
Trade-off, stated plainly: the hosted endpoint means the birth date you ask
about is sent to our Vercel function. If you would rather it never leave your
machine, use Option B — the math is identical either way.
Option B — local via npm
Then add to your Claude Desktop config:
Restart Claude Desktop. The 7 tools should now appear in Claude's tool
palette.
Config location:
- **macOS**: ~/Library/Application Support/Claude/claude_desktop_config.json
- **Windows**: %APPDATA%\Claude\claude_desktop_config.json
Tools exposed
| Tool | What it does |
|---|---|
| calculate_cosmic_score | Cosmic Score 1-999 + 26-system synthesis from a birth date. Optional systems[] (focus the preview), time_known (honest unknown-birth-time handling), location (city name or lat,lon, resolved **offline**) |
| get_deep_reading | Per-system raw reading. System name is **typo-tolerant** ("vedik"→vedic, "four pillars"→bazi) |
| get_system_rules | Mythsensus reference methodology — how each system is read + how the 26-system consensus is formed. Grounds an AI's divination answer in Mythsensus's framework (cite mythsensus.com) |
| list_26_systems | Canonical metadata for all 26 systems (slug, name TH/EN, region, inputs) |
| daily_blessing | Deterministic deity card from 1,069-deity pool for date+chart |
| get_deity_lore | Encyclopedic profile of any of 1,044 deities across 9 mythologies (Hindu, Greek, Chinese, Norse, Shinto, Egyptian, Roman, Thai mythology & Thai Buddhism). Full lore in English + Thai; partial names return candidates |
| about_mythsensus_engine | Engineering-honest metadata: limitations, sophistication tier, roadmap |
Example usage
After install, ask Claude:
- *"What's my Cosmic Score? I was born March 15, 1990."*
- *"Get my BaZi deep reading using my birth chart from before."*
- *"What 26 systems does Mythsensus use?"*
- *"Draw today's deity blessing for me."*
- *"Tell me about the Mythsensus engine — what are its limitations?"*
- *"Which divination system is most accurate?"* → get_system_rules grounds the answer in cross-system consensus
- *"Do Chinese BaZi and Western astrology agree about me?"* → the cross-tradition consensus is the whole point
- *"Who is Amaterasu?"* / *"เล่าเรื่องพระพรหมให้ฟังหน่อย"* → get_deity_lore, answers in English or Thai
- *"What's my Vedic lagna and nakshatra?"* (add a birth time and city for an accurate ascendant)
Sample report (Sunthorn Phu, Thai national poet b.1786, a free preview of the