玄ZenTellEASTERN & WESTERN WISDOM

MODEL CONTEXT PROTOCOL

ZenTell MCP Service

ZenTell MCP provides 15 deterministic calculation tools for BaZi, Zi Wei, Zi Wei patterns, classical excerpt search, Qi Men, Liu Yao, calendars, Western astrology, tarot, date selection, Meihua Yishu and more, compatible with Claude, Cursor and other MCP clients.

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 NameFunctionDescriptionInputs
bazi_chartBaZi chartCalculate BaZi four pillars, hidden stems, ten gods, phase counts, and decade cycles.datetime, zone, gender, dayRule, solar, longitude
ziwei_chartZi Wei chartCalculate Zi Wei Dou Shu twelve palaces with stars, transformations, decade ranges and matched patterns.datetime, zone, gender, dayRule, yearRule, leapRule, solar, longitude
ziwei_patterns_listZi Wei patternsList Sanhe-school pattern catalog; with birth time, return matches for that chart. Deterministic, not predictive.query (optional), datetime+gender (optional)
ziwei_classics_searchZi Wei classics searchSearch public-domain excerpts from Gu Sui Fu, Quan Ji and Quan Shu. Excerpts only; 倪师 text excluded.query, book (optional), limit
qimen_chartQi Men chartCalculate Qi Men Dun Jia rotating chart with Fu Tou Chai Bu and nine palaces.datetime, zone, dayRule
liuyao_castLiu Yao castCast hexagram with original, changed, Na Jia, and relatives. Server random or manual line values.datetime, zone, values (optional)
calendar_convertCalendar convertConvert between Gregorian and Chinese lunar calendars with leap months and solar terms.direction, date/year/month/day/leap
solar_timeSolar timeCalculate apparent solar time with longitude correction and equation of time.datetime, zone, longitude
western_chartWestern natal chartCalculate tropical natal chart with ten bodies, houses, and aspects.datetime, zone, latitude, longitude, houses, orb
tarot_drawTarot drawDraw tarot cards with crypto random shuffle, returning names and keywords.count, reversals
tarot_validateTarot validateValidate user-provided tarot card IDs before interpretation.cards (array of {id, reversed})
numerology_calculateNumerology calculateCalculate life path, expression, soul numbers with Pythagorean and Chaldean methods.name, date, year, masters, yVowel
five_phasesFive phasesFive-phase reflection: input five choices, return phase distribution.values (array of 5 integers 0-4)
zeri_selectDate selectionFind Huangli auspicious days for an activity in a date range (recommended / acceptable / avoid).start, end, activity, birthYear (optional)
meihua_castMeihua castTime 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/mcp

Using 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