Overview
ZenTell MCP is a stateless Model Context Protocol service providing deterministic calculation tools for Eastern and Western traditions. All calculations run server-side with no LLM calls, no persistent state, and no birth data logging.
Endpoint
MCP Endpoint: https://mcp.zentell.app/mcp
Protocol: Streamable HTTP (JSON-RPC 2.0)
Authentication: None required
Available Tools (15)
The following tools are available via MCP tool protocol, returning JSON results:
| Tool Name | Function | Description | Inputs |
|---|---|---|---|
bazi_chart | BaZi chart | Calculate BaZi four pillars, hidden stems, ten gods, phase counts, and decade cycles. | datetime, zone, gender, dayRule, solar, longitude |
ziwei_chart | Zi Wei chart | Calculate Zi Wei Dou Shu twelve palaces with stars, transformations, decade ranges and matched patterns. | datetime, zone, gender, dayRule, yearRule, leapRule, solar, longitude |
ziwei_patterns_list | Zi Wei patterns | List Sanhe-school pattern catalog; with birth time, return matches for that chart. Deterministic, not predictive. | query (optional), datetime+gender (optional) |
ziwei_classics_search | Zi Wei classics search | Search public-domain excerpts from Gu Sui Fu, Quan Ji and Quan Shu. Excerpts only; 倪师 text excluded. | query, book (optional), limit |
qimen_chart | Qi Men chart | Calculate Qi Men Dun Jia rotating chart with Fu Tou Chai Bu and nine palaces. | datetime, zone, dayRule |
liuyao_cast | Liu Yao cast | Cast hexagram with original, changed, Na Jia, and relatives. Server random or manual line values. | datetime, zone, values (optional) |
calendar_convert | Calendar convert | Convert between Gregorian and Chinese lunar calendars with leap months and solar terms. | direction, date/year/month/day/leap |
solar_time | Solar time | Calculate apparent solar time with longitude correction and equation of time. | datetime, zone, longitude |
western_chart | Western natal chart | Calculate tropical natal chart with ten bodies, houses, and aspects. | datetime, zone, latitude, longitude, houses, orb |
tarot_draw | Tarot draw | Draw tarot cards with crypto random shuffle, returning names and keywords. | count, reversals |
tarot_validate | Tarot validate | Validate user-provided tarot card IDs before interpretation. | cards (array of {id, reversed}) |
numerology_calculate | Numerology calculate | Calculate life path, expression, soul numbers with Pythagorean and Chaldean methods. | name, date, year, masters, yVowel |
five_phases | Five phases | Five-phase reflection: input five choices, return phase distribution. | values (array of 5 integers 0-4) |
zeri_select | Date selection | Find Huangli auspicious days for an activity in a date range (recommended / acceptable / avoid). | start, end, activity, birthYear (optional) |
meihua_cast | Meihua cast | Time or number casting; returns original, mutual and changed hexagrams, moving line and Ti/Yong. | method, datetime/zone or numbers |
Resources & Prompts
Resource: zentell_methods — Calculation methodology and conventions documentation (Markdown)
Prompt: zentell_reading_guide — Guidelines for using tools responsibly with suggested output format and disclaimers
Rate Limits
Maximum 60 requests per IP per 60 seconds. Exceeding the limit returns HTTP 429 with a Retry-After header.
Rate limiting uses Cloudflare Workers Rate Limiting, counted per edge location.
Privacy
ZenTell MCP does not store or log birth data. Request body data is used only during single request processing and is not retained afterward.
Rate limiting uses only client IP as key without reading or logging request content.
Using with Claude Desktop
Edit Claude configuration file ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"zentell": {
"url": "https://mcp.zentell.app/mcp"
}
}
}After restarting Claude Desktop, you can call ZenTell tools directly in conversations.
Using with Claude Code
Run the following command to add the MCP server:
claude mcp add zentell --transport streamable-http https://mcp.zentell.app/mcpUsing with Cursor
Edit Cursor configuration file ~/.cursor/mcp.json:
{
"mcpServers": {
"zentell": {
"url": "https://mcp.zentell.app/mcp"
}
}
}After restarting Cursor, ZenTell tools will be available in Composer.
Methodology Note
These tools use traditional calculation rules for cultural learning and reflection. Results depend on disclosed conventions and inputs, with no guarantee of predictive accuracy and no professional advice. Different schools may use different rules; this service follows the specific conventions documented.
View calculation method details
Updated: 2026-10-26