FateTell

com.fatetellPublished by fatetell.comOfficial publisherv0.1.0Updated Nov 3, 2026

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

VerifiedStreamable HTTPWeb executable

Overview

FateTell's hosted MCP server (mcp.fatetell.com), published by fatetell.com; no sign-in required; Streamable HTTP; 9 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Publisher
fatetell.com
Endpoint
mcp.fatetell.com
Last checked

Installation

In SourceWeft

  1. Open FateTell in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.fatetell%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

FateTell MCP

FateTell computes; your AI interprets.

FateTell MCP is a hosted remote MCP server (Streamable HTTP) that returns deterministic BaZi (Four Pillars) charts, Chinese almanac data and the charts saved in a FateTell account to any MCP client. The server calls no language model: the AI you already use reads and explains the results. There is nothing to download or run.

This repository holds the public metadata for that server: a plugin for Claude and Claude Code, a plugin for Cursor, an Agent Plugins package for Hermes Agent, the MCP Registry entry, and the fatetell-bazi skill on how to read FateTell results. The server itself is not in this repository.

Endpoints

EndpointBehaviorUse it for
https://mcp.fatetell.com/mcpDefault. Connecting needs no account; chart casting and the almanac work anonymously. A tool that needs an account answers with an HTTP 401 challenge, and the client then opens FateTell's sign-in page.Claude (web, desktop, mobile), Claude Code, Codex, VS Code, and most other clients
https://mcp.fatetell.com/login/mcpSign in on connect. The first request already answers 401, so sign-in happens while the client is connecting. Every tool on this endpoint is used signed in; there is no anonymous use.Clients that start sign-in only while connecting: Cursor, Grok Bot, Manus, and Hermes Agent's own server entry
https://mcp.fatetell.com/chatgpt/mcpChatGPT's own endpoint; the tools are identical, sign-in follows ChatGPT's app conventions.ChatGPT only

The tools, their inputs and their results are the same on every endpoint. Sign-in uses OAuth 2.1; there is no key or token to configure in advance.

Install

Claude (web, desktop, mobile)

Settings → Connectors → Add → Add custom connector. Name FateTell, URL:

https://mcp.fatetell.com/mcp

Under Authentication choose Sign in when needed (Claude detects "No sign-in" by default because the free tools work without an account; with that choice it never offers sign-in for account features). Leave the OAuth client on Claude's published identity and enter no key. Connectors follow your Claude account, so the desktop and mobile apps pick it up. Once the FateTell plugin is listed in the Claude directory, installing it from there adds the same connector together with the skill.

Claude Code

This repository is also a Claude Code plugin marketplace. The plugin adds the connector (/mcp) and the fatetell-bazi skill:

sh
claude plugin marketplace add RussGuo/fatetell-mcpclaude plugin install fatetell@fatetell

Connector only, without the skill:

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

Add --scope user before the name to use it in every project. To sign in ahead of time, run claude mcp login fatetell; otherwise the first account feature prompts you. /mcp shows the connection status.

Codex

sh
codex mcp add fatetell --url https://mcp.fatetell.com/mcp

Codex opens FateTell's sign-in page right away. If the browser does not open, run codex mcp login fatetell. In the ChatGPT desktop app, Codex has its own page: Settings → Plugins → MCPs → Add, with the same URL.

ChatGPT

On chatgpt.com (or the desktop app): Plugins → Add → Add custom MCP server. Name FateTell, keep Connection on Server URL and use ChatGPT's endpoint:

https://mcp.fatetell.com/chatgpt/mcp

Keep Authentication on OAuth, leave the advanced OAuth settings alone, tick the confirmation and choose Create as a plugin. ChatGPT opens FateTell's sign-in page; choose Allow. Use this endpoint only in ChatGPT.

Cursor

Install FateTell from the Cursor Marketplace once it is listed; the plugin connects to the sign-in endpoint. To add it by hand, open this link and choose Install:

Add to Cursor

or add this entry to ~/.cursor/mcp.json:

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

Cursor asks you to sign in to FateTell while it connects. Cursor handles a sign-in challenge only at that stage, which is why it uses /login/mcp rather than the default endpoint.

VS Code

sh
code --add-mcp '{"name":"fatetell","url":"https://mcp.fatetell.com/mcp"}'

The first time a chat uses a feature that needs your account, follow the prompt to sign in.

Grok Bot

Grok Bot is Cursor's cloud agent. Add FateTell as a remote MCP connector with the sign-in endpoint, or ask Grok Bot to add it for you:

https://mcp.fatetell.com/login/mcp

Manus

On manus.im: Plugins → Create → Custom MCP. Server Name FateTell, Transport Type HTTP, Server URL:

https://mcp.fatetell.com/login/mcp

Leave the headers empty and choose Save; Manus starts sign-in while connecting.

Hermes Agent

This repository is also an Agent Plugins package, which Hermes Agent installs as a plugin. The package adds the connector (/mcp) and the fatetell-bazi skill; Hermes installs it disabled, so enable it afterwards:

sh
hermes plugins install RussGuo/fatetell-mcp --no-enablehermes plugins enable fatetell

Once FateTell is listed in the Hermes plugin catalog, hermes plugins install fatetell installs the same package. Chart casting and the almanac work right away. The package marks the server untrusted, so Hermes asks before any tool call that is not marked read-only; create_saved_chart is the only such tool.

A plugin package cannot declare sign-in, so account features need a server entry of your own. Add this under mcp_servers in your Hermes config.yaml, next to any servers already there:

yaml
mcp_servers:  fatetell:    url: https://mcp.fatetell.com/login/mcp    auth: oauth    trust: untrusted

Then sign in:

sh
hermes mcp login fatetell

This entry replaces the package's connector of the same name, including its trust setting, which is why it repeats trust: untrusted. It uses the sign-in endpoint because Hermes signs in only when the server asks while connecting; on the default endpoint hermes mcp login finds nothing to sign in to. Hermes stores and refreshes the tokens itself.

Other MCP clients

Add a remote MCP server named fatetell over Streamable HTTP (often called http) with the default endpoint, OAuth for authentication and no key or header:

https://mcp.fatetell.com/mcp

If the client connects but never opens a sign-in page when an account feature is used, it is one of the clients that only signs in while connecting: use https://mcp.fatetell.com/login/mcp instead.

An agent that can run commands or edit its own MCP settings can also set itself up from install.md:

Read https://mcp.fatetell.com/install.md and follow it to connect me to FateTell MCP.

Tools

Nine tools, all deterministic. Access tiers are explained under Sign-in and permissions.

ToolTitleAccessScopeWhat it does
cast_bazi_chartCast BaZi chartAnonymous—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.
get_almanacGet almanacAnonymous—Return the Chinese almanac for one to 31 consecutive days: Gregorian and lunar dates, solar terms, and the year, month and day pillars.
get_fatetell_accountGet FateTell accountSigned inaccount:readReturn 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.
list_saved_chartsList saved chartsSigned inchart:readList 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.
get_saved_chartGet saved chartSigned inchart:readReturn 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.
get_bazi_judgmentGet BaZi judgmentMemberchart:readReturn 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.
get_daily_fortuneGet daily fortuneMemberfortune:readReturn 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.
get_chart_calendarGet chart calendarMemberfortune:readReturn 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.
create_saved_chartCreate saved chartMemberchart:writeSave a new chart to the connected FateTell account from name, gender, Gregorian birth date, optional birth time and birthplace; time zone and hemisphere come from the birthplace as in the app.

create_saved_chart is the only tool that writes; it adds a chart and cannot edit or delete existing ones. Every other tool is read-only. Every result carries its rule version, and the same input always gives the same result.

Sign-in and permissions

Three access tiers; each includes everything in the tiers before it.

TierWhat you needTools
AnonymousNothing (default endpoint only)cast_bazi_chart, get_almanac
Signed inA FateTell accountget_fatetell_account, list_saved_charts, get_saved_chart
MemberAn active FateTell membershipget_bazi_judgment, get_daily_fortune, get_chart_calendar, create_saved_chart
  • OAuth 2.1, authorization code with PKCE (S256). The authorization server is https://auth.fatetell.com; you sign in and approve on FateTell's own pages at https://web.fatetell.com. Your AI never sees your password.
  • Client registration: Client ID Metadata Documents and Dynamic Client Registration are both supported, so no client ID needs to be configured.
  • Scopes: account:read (account and membership status), chart:read (saved charts and FateTell's judgment), fortune:read (daily fortune and chart calendar), chart:write (create new charts; listed separately on the consent page), offline_access (stay connected without signing in again). ChatGPT additionally requests openid and email.
  • Membership is checked on every call, not fixed at sign-in. The same membership works in the FateTell app, on the website and here; what you can do here matches what you can do in the app.
  • Disconnecting: FateTell website → System Settings → Connected apps → Disconnect. The AI loses access within a minute.

Testing the connector

For anyone reviewing or trying the connector, with or without a FateTell account:

  1. Connect the default endpoint, https://mcp.fatetell.com/mcp, or let a Cursor, Grok Bot or Hermes setup use the sign-in endpoint. Any email address can sign in: a code is sent to it, and the new account is free.
  2. Without signing in (default endpoint): "Cast my BaZi chart, female, born 1 July 1990 at 10:00 in Sydney" and "What is today's day pillar?" should answer at once.
  3. Signed in on a free account: "Read my saved chart" lists and opens the charts in that account, which is empty for a new one, so create one in the FateTell app or website first, or skip to the next step.
  4. Member tools (Day Master judgment, daily fortune, chart calendar, saving a new chart) need an active membership. A review account with a membership and saved charts is available to directory and marketplace reviewers on request at [email protected]; it is never published in this repository.
  5. Saving a chart is the only write: ask to "save a new chart" and the tool adds one; nothing is edited or deleted. Disconnect from the FateTell website (System Settings → Connected apps) to test revocation.

Usage limits

Every tool has a usage cap. The caps exist only to prevent abuse; they are not an allowance, they are not linked to any usage count in the FateTell app, and reaching one returns only the cap and its reset time.

  • Signed in: each tool has a daily cap per account, plus a combined daily cap. Days run on UTC.
  • Anonymous on the default endpoint: clients that do not identify anonymous users share one public cap that resets hourly. When it runs out, signing in moves you onto your own account's count.
  • Asking the same thing again within 24 hours does not count. One almanac lookup of 1 to 31 days counts once. Checking your account does not count.
  • Saved charts are also limited by the same total as in the app.

Once signed in, get_fatetell_account reports each tool's cap, current use and reset time.

Data and privacy

  • No language model on the server. FateTell MCP computes and reads data. It never sees your conversation with your AI.
  • Anonymous use is not stored. Inputs and results of cast_bazi_chart and get_almanac are not written to any database and are not linked to anyone. To avoid counting repeated questions, a result is held in server memory for up to 24 hours, keyed by a hash of the request, then discarded.
  • Logs record which tool ran, how long it took, the outcome, any error code and a keyed hash of the input. They never record birth dates, birth times, longitudes, place names or chart names.
  • Signed-in reads return only what you approved on the consent page. Saved charts are returned without the birthplace as written and without coordinates.
  • Saving a chart is the only feature that takes a place name: FateTell uses it to find the time zone and hemisphere, exactly as when you create a chart in the app. FateTell MCP itself does not keep or log it. Saving a chart for someone else requires their knowledge and consent.
  • What this repository's plugins send: the plugins contain no code. They connect only to mcp.fatetell.com; sign-in goes through auth.fatetell.com and web.fatetell.com. Nothing is sent anywhere else.

Once your AI has a result, how it stores it (for example in your chat history) is governed by that app's own policy.

BaZi results are for reference and are not a substitute for medical, legal or financial advice. How your AI interprets FateTell's data is the AI's own reading.

Support and security

Registry

MCP Registry name: com.fatetell/mcp. The entry is server.json and lists only the default endpoint, https://mcp.fatetell.com/mcp.

Repository contents

.claude-plugin/plugin.json        Claude plugin manifest (Claude, Cowork, Claude Code).claude-plugin/marketplace.json   single-plugin marketplace: this repository.mcp.json                         Claude plugin connector: https://mcp.fatetell.com/mcp.cursor-plugin/plugin.json        Cursor plugin manifest, connector inline: https://mcp.fatetell.com/login/mcpplugin.json                       Agent Plugins package manifest (Hermes Agent)mcp.json                          Agent Plugins connector: https://mcp.fatetell.com/mcpskills/fatetell-bazi/SKILL.md     reading skill, shared by all three packagesserver.json                       MCP Registry entryassets/                           icons: SVG master and 1024 / 512 PNG on a paper-colored plate, a 512 white-plate variant for directory tiles, and a transparent 512 mark

Validate the Claude plugin with claude plugin validate --strict . and the Hermes package with hermes plugins validate . --install-deps.

License

The files in this repository are released under the MIT License. The license covers this repository only; the FateTell service and its calculation engine are not open source.

Source: README.md at commit b512682

Tools

9

cast_bazi_chart

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.

Parametersbirthrequiredlocaleinclude_today

get_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.

Parametersdaystimezonehemispherestart_date

get_fatetell_account

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.

Takes no parameters.

list_saved_charts

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.

Takes no parameters.

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.

Parameterslocalechart_idrequiredinclude_today

get_bazi_judgment

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.

Parametersbirthchart_id

get_daily_fortune

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.

Parametersdatelocalechart_idrequired

get_chart_calendar

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.

Parameterscountchart_idrequiredstart_dategranularity

create_saved_chart

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.

Parametersgenderrequiredsubjectcalendarbirth_daterequiredbirth_timebirthplacerequireddisplay_namerequiredconsent_attestedlunar_leap_month

Version history

1
  1. v0.1.0LatestNov 3, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts