FateTell MCP Server

by fatetell Your server? Claim it

answering

FateTell is answering right now. Last checked 10 min ago. It exposes 9 tools. Last commit 4 Nov 2026.

Deterministic BaZi (Four Pillars) charts, Chinese almanac and saved FateTell charts.

Uptime history 5 days of history

5 days agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

1127 ms

Response time

average over 24h

Stars

last commit 4 Nov 2026

What the code does

We read the source, 3 d ago · tools taken from the live server · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Page executes code built at runtime skills/fatetell-bazi/chart-card.html:168

    document.getElementById('years').innerHTML = html;

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 10 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add mcp --transport http https://mcp.fatetell.com/mcp

Settings → Connectors → Add custom connector, then paste this address

https://mcp.fatetell.com/mcp

~/.codex/config.toml

[mcp_servers.mcp]
url = "https://mcp.fatetell.com/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.fatetell.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.fatetell.com/mcp"
    }
  }
}

Available tools 9

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

saved

create_saved_chart

Save a new chart to the connected account from name, gender, birth date (Gregorian or lunar), optional birth time and birthplace; time zone and hemisphere come from the birthplace as in the app. Returns the chart_id. Use when the user explicitly asks to save a chart; check list_saved_charts first to avoid duplicates. For another person the user must confirm consent (consent_attested); without it nothing is saved or cast. Not for casting without saving (use cast_bazi_chart), reading (use get_saved_chart) or editing existing charts. New charts return no pillars; read them with get_saved_chart.

get_saved_chart

Return one saved chart in full: birth date, time and time zone (no birthplace), pillars with Ten Gods, hidden stems and Na Yin, all luck pillars (current one marked), palaces, the stored Day Master strength and favorable elements, and today's pillars. Use whenever the user asks about a saved chart or "my chart"; luck pillars and judgment are included. chart_id comes from list_saved_charts, or "self" for the user's own chart. Not for births not saved (use cast_bazi_chart). Never re-cast or re-judge a saved chart with other tools. Not for predicting events or years of accident, illness or death.

list_saved_charts

List the charts saved in the connected FateTell account: id, display name, gender, whether it is the user's own chart, hemisphere, chart rule version and whether the chart has been computed. Use first whenever the user refers to "my chart", a family member's chart or any saved profile, to get the chart_id that get_saved_chart, get_bazi_judgment, get_daily_fortune and get_chart_calendar need. Do not ask for birth data when a saved chart may exist. Not for creating charts (use create_saved_chart) or reading a chart's content (use get_saved_chart). Birthplace and coordinates are never returned.

almanac

get_almanac

Return the Chinese almanac for one to 31 consecutive days: Gregorian and lunar dates, solar terms, and the year, month and day pillars. The month pillar is given for both hemispheres. Use for questions like "What is today's day pillar?", "When is the next solar term?", or to get the stems and branches of upcoming days or months for date selection. Not for a person's chart or days: use get_saved_chart or cast_bazi_chart for a chart, get_daily_fortune or get_chart_calendar for a saved chart's days. Not for Western astrology. Deterministic; no personal data involved.

bazi

get_bazi_judgment

Return FateTell's Day Master verdict (strong, weak, follow-strong, follow-weak) and ranked favorable, unfavorable and neutral elements under rule set v1.0, for birth data or a saved chart_id. Use when the user asks about strength or favorable elements for a birth not saved (pass birth), or for a saved chart whose judgment get_saved_chart reported as not yet available (pass chart_id). Not a substitute for the chart (use cast_bazi_chart for pillars). For a saved chart, get_saved_chart already includes this judgment. Deterministic; nothing stored. Requires an active FateTell membership.

cast

cast_bazi_chart

Compute a BaZi chart from birth data: pillars with Ten Gods, hidden stems, Na Yin, Day Master, all luck pillars, palaces and today's pillars; southern-hemisphere births use cross-region rules. Use for a birth not saved in FateTell, e.g. "What is my BaZi? Born 1990-05-17 08:30 in Taipei". Not for a saved chart (get_saved_chart already has its pillars, luck pillars and judgment; do not rebuild its birth data for this), Day Master strength (get_bazi_judgment), calendar (get_almanac), Western astrology, or predicting events or years of accident, illness or death. Deterministic; nothing stored.

chart

get_chart_calendar

Return a saved chart's view of upcoming dates: for each day (up to 31) the year, month and day pillars adjusted for this chart's hemisphere, relations with the natal pillars, month clash and solar terms; or for each month (up to 12) the month pillar and its natal relations. Use to pick a date or see upcoming days or months for a saved chart. Only stems, branches and relations are returned; interpretation is left to you. Not for one day's energy level or do/avoid items (use get_daily_fortune) or dates without a chart (use get_almanac). Needs a chart_id; it cannot take birth data.

daily

get_daily_fortune

Return a saved chart's daily fortune for one date: energy level (high / medium / low), the day's stems-and-branches relations with the natal chart, the day's do/avoid items, the day pillar, this chart's year and month pillars and month clash. Use for how a specific day looks for a saved chart, e.g. "How is today for me?". Pass chart_id (or "self") and optionally a date; the default is today in the account's time zone. Not for a day's pillars without a chart (use get_almanac), several days at once (use get_chart_calendar), or births not saved. Contains no generated text.

fatetell

get_fatetell_account

Return the connected FateTell account: masked email, sign-in method, interface language, time zone, membership status, the permissions granted to this client, and this account's remaining quota for each tool. Use when the user asks which account is connected, whether membership is active, how many calls remain, or when a tool returned membership_required or rate_limited. Not for reading charts (use list_saved_charts / get_saved_chart). Read-only.

Endpoints

URL	Transport	State	Latency	Checked
https://mcp.fatetell.com/mcp	streamable-http	answering	1177 ms	10 min ago

Alternatives to FateTell

same job, measured the same way

Qimen Dunjia & BaZi Charts

by wyl743405571-cpu

Free Qimen Dunjia and BaZi charts via MCP - deterministic engine, nine palaces and four pillars.

2 tools answering

Ba-Zi.ai Chinese Astrology

by xlw-pro

BaZi Four Pillars charts, bone weight fortune (称骨) and Chinese almanac (黄历) by Ba-Zi.ai.

57 installs/wk local only

Ancient Echoes

by flamescn

Deterministic BaZi and Chinese metaphysics tools for AI agents: charts, divination, almanac.

answering

Syl Pulse

by sylai

Causal analytics: ask a business question, get a deterministic causal answer and charts.

1 tools answering

bazi-chart

by liyooh007

Chinese BaZi Four Pillars engine: precise solar terms, true-solar-time, lunar, patterns, offline.

413 installs/wk local only

知己排盘 BaZi

by zhijipaipan

BaZi (Chinese Four Pillars) chart calculator. Structured chart data only, no predictions.

186 installs/wk 1 tools answering

Fatenava MCP

by fatenava

Cast BaZi, Zi Wei Dou Shu, and Western astrology natal charts - deterministic, free, no account.

59 installs/wk local only

Cafe MCP

by dangamsoft

Saju & BaZi (Four Pillars) charts, luck cycles, manseryeok and classics. Free with sign-in.

6 tools answering

FateTell — questions

Answers built from our own checks of this server.

What can FateTell do?

It exposes 9 tools, read directly from the server on our last check. Among them: cast_bazi_chart, create_saved_chart, get_almanac, get_bazi_judgment, get_chart_calendar, get_daily_fortune and 3 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is FateTell working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 1127 ms. The bar chart above shows every period we have measured.

How do I connect FateTell?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does FateTell need an API key?

No. FateTell completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 9 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is FateTell?

It answers our handshake in 1127 ms on average, which is faster than 3% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is FateTell open source?

The code is open source: it is published under the MIT licence, written in HTML and 1 stars on GitHub. The licence covers the code in the repository, not the hosted service at mcp.fatetell.com, which runs on its operator's own terms.