FateTell

FateTell MCP

FateTell が計算し、AI が解釈します。

FateTell MCP は、ホストされたリモート MCP サーバー（Streamable HTTP）です。決定論的な BaZi（四柱推命）の命式、中国の暦のデータ、および FateTell アカウントに保存された命式を、あらゆる MCP クライアントに返します。サーバーは言語モデルを呼び出しません。お使いの AI が結果を読み取り、説明します。ダウンロードや実行は必要ありません。

このリポジトリには、このサーバーの公開メタデータが含まれています。Claude と Claude Code 用のプラグイン、Cursor 用のプラグイン、Hermes Agent 用の Agent Plugins パッケージ、MCP Registry のエントリー、および FateTell の結果の読み方を説明する fatetell-bazi スキルです。サーバー自体はこのリポジトリには含まれていません。

エンドポイント

エンドポイント	動作	用途
https://mcp.fatetell.com/mcp	デフォルトです。接続にアカウントは不要です。命式の作成と暦の機能は匿名で利用できます。アカウントが必要なツールは HTTP 401 チャレンジを返し、その後クライアントが FateTell のサインインページを開きます。	Claude（ウェブ、デスクトップ、モバイル）、Claude Code、Codex、VS Code、およびほとんどのクライアント
https://mcp.fatetell.com/login/mcp	接続時にサインインします。最初のリクエストですでに 401 が返されるため、クライアントの接続中にサインインが行われます。このエンドポイントでは、すべてのツールがサインイン済みの状態で使用されます。匿名での利用はできません。	接続中にのみサインインを開始するクライアント：Cursor、Grok Bot、Manus、Hermes Agent 独自のサーバーエントリー
https://mcp.fatetell.com/chatgpt/mcp	ChatGPT 専用のエンドポイントです。ツールは同一で、サインインは ChatGPT アプリの規約に従います。	ChatGPT のみ

ツール、その入力、結果はすべてのエンドポイントで同じです。サインインには OAuth 2.1 を使用します。事前にキーやトークンを設定する必要はありません。

インストール

Claude（ウェブ、デスクトップ、モバイル）

Settings → Connectors → Add → Add custom connector を選択します。名前に FateTell を入力し、URL に次を指定します。

https://mcp.fatetell.com/mcp

Authentication で Sign in when needed を選択します（無料ツールはアカウントなしで動作するため、Claude はデフォルトで「No sign-in」と判断します。この設定では、アカウントが必要な機能を使う際にもサインインの選択肢が表示されません）。OAuth クライアントは Claude が公開している ID のままにし、キーは入力しないでください。コネクターは Claude アカウントに紐づくため、デスクトップアプリとモバイルアプリでも利用できます。Claude ディレクトリに FateTell プラグインが掲載されたら、そこからインストールすると、同じコネクターとスキルが追加されます。

Claude Code

このリポジトリは Claude Code のプラグインマーケットプレイスでもあります。このプラグインは、コネクター（/mcp）と fatetell-bazi スキルを追加します。

claude plugin marketplace add RussGuo/fatetell-mcp
claude plugin install fatetell@fatetell

スキルを使わず、コネクターだけを追加する場合：

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

すべてのプロジェクトで使用するには、名前の前に --scope user を追加します。事前にサインインするには、claude mcp login fatetell を実行してください。そうでない場合は、アカウントが必要な機能を初めて使う際にサインインを求められます。/mcp で接続状態を確認できます。

Codex

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

Codex は FateTell のサインインページをすぐに開きます。ブラウザーが開かない場合は、codex mcp login fatetell を実行してください。ChatGPT デスクトップアプリでは、Codex の設定ページから追加できます。Settings → Plugins → MCPs → Add に進み、同じ URL を入力します。

ChatGPT

chatgpt.com（またはデスクトップアプリ）で、Plugins → Add → Add custom MCP server を選択します。名前に FateTell を入力し、Connection は Server URL のままにして、ChatGPT のエンドポイントを使用します。

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

Authentication は OAuth のままにし、OAuth の詳細設定は変更せず、確認欄にチェックを入れて Create as a plugin を選択します。ChatGPT が FateTell のサインインページを開くので、Allow を選択してください。このエンドポイントは ChatGPT でのみ使用してください。

Cursor

掲載されたら、Cursor Marketplace から FateTell をインストールしてください。このプラグインはサインイン用エンドポイントに接続します。手動で追加するには、次のリンクを開いて Install を選択します。

Cursor に追加

または、~/.cursor/mcp.json に次のエントリーを追加します。

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

接続中に Cursor から FateTell へのサインインを求められます。Cursor がサインインチャレンジを処理するのはこの段階のみです。そのため、デフォルトのエンドポイントではなく /login/mcp を使用します。

VS Code

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

チャットでアカウントが必要な機能を初めて使う際は、プロンプトに従ってサインインしてください。

Grok Bot

Grok Bot は Cursor のクラウドエージェントです。サインインエンドポイントを使って FateTell をリモート MCP コネクターとして追加するか、Grok Bot に追加を依頼してください。

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

Manus

manus.im で、Plugins → Create → Custom MCP を選びます。Server Name に FateTell、Transport Type に HTTP を設定し、Server URL に次を入力します。

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

ヘッダーは空欄のまま Save を選択してください。接続中に Manus がサインインを開始します。

Hermes Agent

このリポジトリは Agent Plugins パッケージでもあり、Hermes Agent はこれをプラグインとしてインストールします。このパッケージはコネクター（/mcp）と fatetell-bazi スキルを追加します。Hermes は無効な状態でインストールするため、インストール後に有効化してください。

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

Hermes のプラグインカタログに FateTell が掲載されていれば、hermes plugins install fatetell で同じパッケージをインストールできます。命式の作成と暦はすぐに利用できます。このパッケージはサーバーを信頼されていないものとして設定しているため、Hermes は読み取り専用とされていないツールを呼び出す前に確認を求めます。該当するツールは create_saved_chart のみです。

プラグインパッケージではサインインを宣言できないため、アカウント機能を使うには独自のサーバーエントリーが必要です。Hermes の config.yaml で、既存のサーバーの隣にある mcp_servers の下へ次を追加してください。

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

次にサインインします。

hermes mcp login fatetell

このエントリーは、同名のパッケージのコネクターを信頼設定も含めて置き換えるため、trust: untrusted を再度指定しています。Hermes は接続中にサーバーから要求された場合にのみサインインするため、サインインエンドポイントを使用します。デフォルトのエンドポイントでは、hermes mcp login はサインイン先を見つけられません。Hermes はトークンを自身で保存し、更新します。

その他の MCP クライアント

デフォルトのエンドポイントを使い、Streamable HTTP（http と呼ばれることもあります）経由で、認証に OAuth を使用し、キーやヘッダーを指定せずに、fatetell という名前のリモート MCP サーバーを追加してください。

https://mcp.fatetell.com/mcp

クライアントが接続しても、アカウント機能の使用時にサインインページが開かない場合は、接続中にのみサインインするクライアントです。代わりに https://mcp.fatetell.com/login/mcp を使用してください。

コマンドの実行や独自の MCP 設定の編集ができるエージェントは、install.md を使って自分で設定することもできます。

https://mcp.fatetell.com/install.md を読み、手順に従って FateTell MCP に接続してください。

ツール

9つのツールがあり、すべて決定論的です。アクセス階層については、サインインと権限をご覧ください。

ツール	タイトル	アクセス	スコープ	機能
cast_bazi_chart	BaZi チャートを作成	匿名	—	出生データから BaZi チャートを計算します。十神を含む柱、蔵干、納音、日主、すべての大運、宮、および今日の柱が含まれます。南半球での出生には地域間ルールを適用します。
get_almanac	暦を取得	匿名	—	1〜31日間の連続した日付について、中国暦を返します。グレゴリオ暦と旧暦の日付、節気、年柱・月柱・日柱が含まれます。
get_fatetell_account	FateTell アカウントを取得	サインイン済み	account:read	接続中の FateTell アカウント情報を返します。マスキングされたメールアドレス、サインイン方法、インターフェース言語、タイムゾーン、メンバーシップの状態、このクライアントに付与された権限、および各ツールのアカウント残り利用枠が含まれます。
list_saved_charts	保存済みチャートを一覧表示	サインイン済み	chart:read	接続中の FateTell アカウントに保存されたチャートを一覧表示します。ID、表示名、性別、ユーザー本人のチャートかどうか、半球、チャートルールのバージョン、チャートが計算済みかどうかが含まれます。
get_saved_chart	保存済みチャートを取得	サインイン済み	chart:read	保存済みチャート1件の全情報を返します。出生年月日、出生時刻とタイムゾーン（出生地は含みません）、十神・蔵干・納音を含む柱、現在の大運を示したすべての大運、宮、保存済みの日主の強弱と喜神、および今日の柱が含まれます。
get_bazi_judgment	BaZi 判定を取得	メンバー	chart:read	出生データまたは保存済みの chart_id に対して、FateTell の日主判定（身強、身弱、従強、従弱）と、ルールセット v1.0 に基づく喜神・忌神・中立の五行を順位付きで返します。
get_daily_fortune	日運を取得	メンバー	fortune:read	保存済みチャートについて、指定日の運勢を返します。エネルギーレベル（高／中／低）、命式とその日の干支の関係、その日の宜忌、日柱、このチャートの年柱と月柱、および月破が含まれます。
get_chart_calendar	チャートカレンダーを取得	メンバー	fortune:read	保存済みチャートに基づく今後の日付の見通しを返します。日ごとの情報（最大31日）には、このチャートの半球に合わせた年柱・月柱・日柱、命式との関係、月破、節気が含まれます。月ごとの情報（最大12か月）には、月柱と命式との関係が含まれます。
create_saved_chart	保存済みチャートを作成	メンバー	chart:write	名前、性別、グレゴリオ暦の生年月日、および任意の出生時刻と出生地から、新しいチャートを接続中の FateTell アカウントに保存します。アプリと同様に、タイムゾーンと半球は出生地から決定されます。

書き込みを行うツールは create_saved_chart のみです。チャートを追加しますが、既存のチャートを編集または削除することはできません。それ以外のツールはすべて読み取り専用です。すべての結果にはルールのバージョンが含まれ、同じ入力には常に同じ結果が返されます。

サインインと権限

3つのアクセス階層があり、それぞれに前の階層のすべてが含まれます。

階層	必要なもの	ツール
匿名	なし（デフォルトのエンドポイントのみ）	cast_bazi_chart、get_almanac
サインイン済み	FateTell アカウント	get_fatetell_account、list_saved_charts、get_saved_chart
メンバー	有効な FateTell メンバーシップ	get_bazi_judgment、get_daily_fortune、get_chart_calendar、create_saved_chart

• OAuth 2.1、PKCE（S256）を使用した認可コードフローです。認可サーバーは https://auth.fatetell.com です。FateTell 独自のページ（https://web.fatetell.com）でサインインして承認します。AI にパスワードが知られることはありません。
• クライアント登録：Client ID Metadata Documents と Dynamic Client Registration の両方に対応しているため、クライアント ID の設定は不要です。
• スコープ：account:read（アカウントとメンバーシップの状態）、chart:read（保存済みのチャートと FateTell の判定）、fortune:read（毎日の運勢とチャートカレンダー）、chart:write（新しいチャートの作成。承認ページでは別個に表示）、offline_access（再度サインインせずに接続を維持）。ChatGPT はさらに openid と email を要求します。
• メンバーシップはサインイン時に固定されず、呼び出しのたびに確認されます。FateTell アプリ、ウェブサイト、ここで同じメンバーシップを利用でき、ここでできることはアプリでできることと同じです。
• 接続の解除：FateTell のウェブサイト → システム設定 → 接続済みアプリ → 接続を解除。AI は1分以内にアクセスできなくなります。

コネクターのテスト

FateTell アカウントの有無を問わず、コネクターを確認したり試したりする場合：

1. デフォルトのエンドポイント https://mcp.fatetell.com/mcp に接続するか、Cursor、Grok Bot、Hermes の設定でサインイン用エンドポイントを使用します。どのメールアドレスでもサインインできます。コードがそのアドレスに送信され、新しいアカウントは無料です。
2. サインインせずに（デフォルトのエンドポイントで）、「私の八字チャートを作成してください。女性、1990年7月1日午前10時、シドニー生まれ」と「今日の日柱は何ですか？」と尋ねると、すぐに回答が得られます。
3. 無料アカウントでサインインした状態で「保存済みのチャートを読んでください」と尋ねると、そのアカウントのチャート一覧が表示され、チャートが開きます。新規アカウントにはチャートがないため、先に FateTell アプリまたはウェブサイトで作成するか、次の手順に進んでください。
4. メンバーツール（Day Master の判定、毎日の運勢、チャートカレンダー、新しいチャートの保存）には有効なメンバーシップが必要です。メンバーシップと保存済みチャートがあるレビュー用アカウントは、ディレクトリーおよびマーケットプレイスのレビュー担当者からのリクエストに応じて提供されます。[email protected] までご連絡ください。このリポジトリで公開されることはありません。
5. 保存は唯一の書き込み操作です。「新しいチャートを保存して」と依頼すると、ツールがチャートを1つ追加します。編集や削除は行われません。アクセス権の取り消しをテストするには、FateTell のウェブサイト（システム設定 → 接続済みアプリ）から接続を解除してください。

使用制限

各ツールには使用上限があります。上限は不正利用の防止のみを目的としており、利用枠ではありません。また、FateTell アプリの使用回数とは連動していません。上限に達した場合に返されるのは、上限とリセット時刻のみです。

• サインイン済みの場合：各ツールにアカウントごとの1日あたりの上限があり、さらに全ツール共通の1日あたりの上限もあります。日付は UTC に基づきます。
• デフォルトのエンドポイントで匿名利用する場合：匿名ユーザーを識別しないクライアントは、1時間ごとにリセットされる共通の公開上限を共有します。上限に達した後、サインインすると、自分のアカウントの使用回数が適用されます。
• 24時間以内に同じ内容を再度尋ねても、使用回数には加算されません。1～31日分の暦を1回調べた場合、1回として数えられます。アカウントの確認は使用回数に加算されません。
• 保存済みチャートにも、アプリと同じ合計数の上限があります。

サインインすると、get_fatetell_account で各ツールの上限、現在の使用回数、リセット時刻を確認できます。

データとプライバシー

• サーバー上に言語モデルはありません。 FateTell MCP はデータを計算して読み取ります。AI との会話を見ることはありません。
• 匿名での利用は保存されません。 cast_bazi_chart と get_almanac の入力および結果は、データベースに書き込まれず、誰かに紐付けられることもありません。同じ質問が繰り返し数えられるのを防ぐため、リクエストのハッシュをキーとして、結果をサーバーのメモリに最大 24 時間保持した後、破棄します。
• ログには、実行されたツール、所要時間、結果、エラーコード（ある場合）、および入力のキー付きハッシュが記録されます。生年月日、出生時刻、経度、地名、命式名は記録されません。
• サインインして閲覧する場合は、同意ページで承認した内容のみが返されます。保存済みの命式は、入力された出生地の表記と座標を含めずに返されます。
• 命式の保存は、地名を必要とする唯一の機能です。FateTell は、アプリで命式を作成するときと同様に、タイムゾーンと半球の特定に地名を使用します。FateTell MCP 自体が地名を保持または記録することはありません。他の人の命式を保存するには、その人の認識と同意が必要です。
• このリポジトリのプラグインが送信するデータ：プラグインにはコードが含まれていません。mcp.fatetell.com のみに接続します。サインインは auth.fatetell.com および web.fatetell.com を経由します。それ以外の場所にデータが送信されることはありません。

AI が結果を取得した後、その結果をどのように保存するか（チャット履歴など）は、そのアプリ独自のポリシーに従います。

BaZi の結果は参考情報であり、医療、法律、金融に関する助言に代わるものではありません。AI が FateTell のデータをどのように解釈するかは、AI 独自の判断です。

• プライバシーポリシー：https://fatetell.com/privacyPolicy（MCP 経由の接続についてはセクション 8 をご覧ください：https://fatetell.com/privacyPolicy#mcp）
• 利用規約：https://fatetell.com/terms（MCP サービスの規約についてはセクション 9 をご覧ください：https://fatetell.com/terms#mcp）
• ドキュメント：https://fatetell.com/mcp/docs · お問い合わせ：https://fatetell.com/mcp/faq

サポートとセキュリティ

• サポート：[email protected]
• セキュリティに関する報告：件名に「Security」と記載のうえ、[email protected] までご連絡ください。脆弱性は公開 issue ではなく、非公開でご報告ください。

レジストリ

MCP レジストリ名：com.fatetell/mcp。エントリは server.json で、デフォルトのエンドポイント https://mcp.fatetell.com/mcp のみを記載しています。

リポジトリの内容

.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/mcp
plugin.json                       Agent Plugins package manifest (Hermes Agent)
mcp.json                          Agent Plugins connector: https://mcp.fatetell.com/mcp
skills/fatetell-bazi/SKILL.md     reading skill, shared by all three packages
server.json                       MCP Registry entry
assets/                           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

claude plugin validate --strict . で Claude プラグインを、hermes plugins validate . --install-deps で Hermes パッケージを検証します。

ライセンス

このリポジトリ内のファイルは、MIT License の下で公開されています。このライセンスの対象はこのリポジトリのみです。FateTell サービスとその計算エンジンはオープンソースではありません。