Mu
News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.
Genealogical research on FamilySearch: historical places, indexed records, page images, the tree.
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 4/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 16/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
FamilySearch をインストールして。https://mcp.popnx.com/i/ianderso-familysearch-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
FamilySearch のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server FamilySearch を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "familysearch": { "command": "uvx", "args": [ "familysearch-mcp" ], "env": { "FS_ACCESS_TOKEN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FS_ACCESS_TOKEN は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、FamilySearch のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
SettingsDeveloperEdit Config
{
"mcpServers": {
"familysearch": {
"command": "uvx",
"args": [
"familysearch-mcp"
],
"env": {
"FS_ACCESS_TOKEN": "your-value"
}
}
}
}キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
FamilySearch を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が FamilySearch を使っていると言うか、回答に FamilySearch のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
FS_ENV_FILE 設定の読み込みと、セッション中に更新されたトークンの再読み込みに使用する env ファイル。デフォルトは作業ディレクトリから上方向にたどって最初に見つかった .env。 FS_CLIENT_ID 登録済みアプリケーションの client id。auth_status によって報告されます。 FS_ENVIRONMENT production、または FamilySearch サンドボックス用の integration。 FS_TIMEOUT HTTP のタイムアウト(秒)。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ FamilySearch につなげません
FamilySearch はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · FamilySearch につなげるアプリを使う
B · 旅行・地図・天気 の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
FamilySearch のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server FamilySearch を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user familysearch --env FS_ACCESS_TOKEN=your-value -- uvx familysearch-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FS_ACCESS_TOKEN は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、FamilySearch のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user familysearch --env FS_ACCESS_TOKEN=your-value -- uvx familysearch-mcpEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
FamilySearch が一覧にあり、接続済みと表示されれば OK です
FamilySearch を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が FamilySearch を使っていると言うか、回答に FamilySearch のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
FS_ENV_FILE 設定の読み込みと、セッション中に更新されたトークンの再読み込みに使用する env ファイル。デフォルトは作業ディレクトリから上方向にたどって最初に見つかった .env。 FS_CLIENT_ID 登録済みアプリケーションの client id。auth_status によって報告されます。 FS_ENVIRONMENT production、または FamilySearch サンドボックス用の integration。 FS_TIMEOUT HTTP のタイムアウト(秒)。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
FamilySearch のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server FamilySearch を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "familysearch": { "command": "uvx", "args": [ "familysearch-mcp" ], "env": { "FS_ACCESS_TOKEN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FS_ACCESS_TOKEN は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、FamilySearch のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
FamilySearch の設定で FS_ACCESS_TOKEN が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
FamilySearch を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が FamilySearch を使っていると言うか、回答に FamilySearch のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
FS_ENV_FILE 設定の読み込みと、セッション中に更新されたトークンの再読み込みに使用する env ファイル。デフォルトは作業ディレクトリから上方向にたどって最初に見つかった .env。 FS_CLIENT_ID 登録済みアプリケーションの client id。auth_status によって報告されます。 FS_ENVIRONMENT production、または FamilySearch サンドボックス用の integration。 FS_TIMEOUT HTTP のタイムアウト(秒)。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
FamilySearch のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server FamilySearch を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "familysearch": { "type": "stdio", "command": "uvx", "args": [ "familysearch-mcp" ], "env": { "FS_ACCESS_TOKEN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FS_ACCESS_TOKEN は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、FamilySearch のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
FamilySearch の設定で FS_ACCESS_TOKEN が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
FamilySearch を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が FamilySearch を使っていると言うか、回答に FamilySearch のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
FS_ENV_FILE 設定の読み込みと、セッション中に更新されたトークンの再読み込みに使用する env ファイル。デフォルトは作業ディレクトリから上方向にたどって最初に見つかった .env。 FS_CLIENT_ID 登録済みアプリケーションの client id。auth_status によって報告されます。 FS_ENVIRONMENT production、または FamilySearch サンドボックス用の integration。 FS_TIMEOUT HTTP のタイムアウト(秒)。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Claude Code
claude mcp add --scope user familysearch --env FS_ACCESS_TOKEN=your-value -- uvx familysearch-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"familysearch": {
"command": "uvx",
"args": [
"familysearch-mcp"
],
"env": {
"FS_ACCESS_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"familysearch": {
"command": "uvx",
"args": [
"familysearch-mcp"
],
"env": {
"FS_ACCESS_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"familysearch": {
"type": "stdio",
"command": "uvx",
"args": [
"familysearch-mcp"
],
"env": {
"FS_ACCESS_TOKEN": "your-value"
}
}
}
}FS_ACCESS_TOKEN 秘密 必須 envFS_ENV_FILE envFS_CLIENT_ID envFS_ENVIRONMENT envFS_TIMEOUT env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント ianderso で確認済みです
コードの最終更新:5 日前
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に familysearch-mcp@1.4.0 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/ianderso-familysearch-mcp)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:FS_ACCESS_TOKEN
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は5 日前、最新バージョン(1.4.0)がレジストリに届いたのは39 日前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。
同じカテゴリには:Mu, Award Travel Finder, Killbottleneck, Whimsical, HasData Google Maps
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.
Search award flight availability and points pricing across 27 airlines and 23 loyalty programs.
Free-to-self-host goal and process maps for humans and AI agents, with REST API and MCP.
Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.
Google Maps places, reviews, contributor history, photos and posts as JSON. No Google Cloud.
| これ FamilySearch | Mu | Award Travel Finder | Killbottleneck | Whimsical | HasData Google Maps | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドでもパソコンにインストールでも使える |
| キーが必要 | はい | いいえ | いいえ | はい | いいえ | はい |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | はい | いいえ |
| 基本チェック | 3/3 | 4/4 | 3/3 | 3/3 | 4/4 | 5/5 |
| ライセンス | MIT | AGPL-3.0 | MIT | MIT | MIT | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
An MCP server for genealogical research on FamilySearch: a historical place gazetteer, indexed record search, the page images behind the records, and reads of the shared family tree.
Nothing here writes to FamilySearch. The shared tree is community-edited and conflations of same-named people are common, so a tree result is a hint: follow it to the underlying record and cite that.
This is an independent project. It is not made, endorsed or supported by FamilySearch.
This package ships no client id and never handles a FamilySearch password. Records, images and the tree need an access token from your own registered FamilySearch application; docs/AUTH.md explains why, and how to get one.
The gazetteer, the collection catalogue and the film browser answer without a token, so they work on a fresh install with no setup at all.
uvx familysearch-mcp
That runs the server over stdio, which is how an MCP client starts it. You normally put it in the client's configuration rather than running it yourself.
{
"mcpServers": { "familysearch": { "command": "uvx", "args": ["familysearch-mcp"], "env": { "FS_ENV_FILE": "/path/to/familysearch.env" } } } }
Point at an env file rather than pasting the token into env. A token that lives in the client's config can only be replaced by editing it and restarting; a token in the file is picked up mid-session. With no token at all, leave env out and the anonymous tools still work.
claude mcp add familysearch -e FS_ENV_FILE=/path/to/familysearch.env -- uvx familysearch-mcp
| Variable | Meaning |
|---|---|
FS_ACCESS_TOKEN | Bearer token from your application's OAuth flow. |
FS_ENV_FILE | The env file to read these settings from, and to re-read a refreshed token from. Default: the nearest .env from the working directory upward. |
FS_CLIENT_ID | Your registered application's client id, reported by auth_status. |
FS_ENVIRONMENT | production (default) or integration for the FamilySearch sandbox. |
FS_TIMEOUT | HTTP timeout in seconds. Default 60. |
.env.example lists them with comments.
Twenty-eight tools. All of them read; download_image also writes the page it fetches to a local file.
FamilySearch's Places API answers anonymously.
| Tool | Needs a token | Purpose |
|---|---|---|
search_places | no | Resolve a place name to its full jurisdictional form and coordinates. |
search_places_at_date | no | Resolve a place *as it was* in a given year. A record naming a county that no longer exists is normal; filing it under the modern one is an invisible error. |
get_place | no | Read one place: jurisdictional chain, type, coordinates, and the dates that jurisdiction existed. |
get_place_jurisdictions | no | Walk the containment chain upward — what turns "Kaskaskia" into "Kaskaskia, Randolph, Illinois, United States". |
get_place_children | no | The places directly inside a jurisdiction — the downward walk. |
| Tool | Needs a token | Purpose |
|---|---|---|
search_records | yes | Search historical records by name, life events, parents, spouse, record type or collection. Every criterion filters, and the result says which FamilySearch applied exactly, relaxed or ignored. Returns one hit per record, with the others named on it. |
get_record | yes | Read one indexed record in full: every person on it and the labelled fields behind each. |
get_record_image | yes | Find the document image a record came from, or the film number when no image was published. |
get_records_on_image | yes | Every record indexed from one image. A census page carries forty people. |
fulltext_search | yes | Search the handwriting-recognised text of page images, mostly deeds, wills, probate and court files, for a name or phrase anywhere on the page. A machine reading: open the image and cite that. |
search_collections | no | Find a record collection by the words of its title, with its coverage, and how big and how old the cached catalogue is. |
get_collection | no | Read one collection: what it covers and how much of it there is. |
get_collection_fields | no | Decode a collection's indexed field codes (PR_FTHR_NAME → "Father's Name"). |
browse_waypoints | no | Browse a collection's places, volumes and images, to reach pages the index never covered. |
get_catalog_entry | yes | Read a FamilySearch Catalog entry: title, authors, places, notes, and each film or DGS with its description, image count and whether you can view it. contains narrows an entry of thousands to the volume or case you want; film_number finds the entry, and the volume, from a bare DGS or microfilm number. |
| Tool | Needs a token | Purpose |
|---|---|---|
get_image_links | for the page | Resolve an image ark to fetchable URLs: full page, deep zoom, thumbnails, neighbouring pages, and with a token the film and image number a citation needs. Without a token only the navigation comes back. |
get_film_image | for the page | Reach a page by film and image number when a citation gives those instead of an ark. Checking the page exists needs no token. |
download_image | yes | Download a page image to a new local file so it can be read. |
Every tool here reads a community-edited profile, and says so in its own description.
| Tool | Needs a token | Purpose |
|---|---|---|
get_person | yes | Read a shared-tree person: names, sex, facts. |
get_person_relatives | yes | Parents, spouses, children and siblings in one call. |
get_person_sources | yes | What the tree attaches as sources, and which facts each supports. The fastest route out of the tree. |
get_ancestry | yes | Pedigree walk back, up to 8 generations, numbered by Ahnentafel. |
get_descendancy | yes | Pedigree walk forward, up to 4 generations. |
get_person_memories | yes | Attached photographs, documents and stories. |
get_person_changes | yes | The change log: who edited this profile, when, and why. |
get_matches | yes | FamilySearch's own duplicate and record-match candidates. |
compare_person | yes | Compare your own record of a deceased person with their profile: what agrees, what the profile lacks, what differs, and one proposed change per packet for you to make by hand. |
| Tool | Needs a token | Purpose |
|---|---|---|
auth_status | no | Report what is configured, what is missing, and whether FamilySearch still accepts the token. |
get_person_sources is the most useful of them because it leads out of the tree towards a document.compare_person takes your own names, events, relatives and sources for one person, reads the profile, and reports what agrees, what the profile lacks and what differs. Each proposed change comes as a packet: the source, the facts to tag it to, a draft reason with gaps for you to fill, and where on the website to make it. You make the change yourself, one at a time, after reading the record. It refuses anyone who may be living, and it never proposes combining profiles, removing anything, replacing a relationship or changing living status. See docs/COMPARE.md.get_record returns the indexed fields behind it, and get_record_image the document itself. Read down that chain before citing.search_places_at_date resolves a place as it was in a given year. Filing an 1820 record under the county that covers the ground today is a common and hard-to-spot error.search_records asks the service the FamilySearch website uses instead, with your token and a browser User-Agent, which that service requires. It is undocumented and FamilySearch can change or close it; docs/API-NOTES.md has the comparison.fulltext_search asks the website's full-text service, on the same footing as record search: your token, a browser User-Agent, and an undocumented route. Its text is handwriting recognition, so names and numbers are often misread; each hit gives the passages that matched and the page's image ark, and the page is what to read and cite. Only some collections and volumes have been machine-read, so no result proves nothing. Every word must match unless you write OR, because the service otherwise matches any one of them.get_catalog_entry reads the entry the website's catalog page reads, on the same footing as record search. For each film it reports the DGS number, which get_film_image and fulltext_search take, and asks the image store whether your account may view it and how many images it holds. A DGS is not the microfilm number; a film may be restricted or never digitised; and a description is a cataloguer's summary, so read the images and cite them.loose=True goes back to ranking. Even required, a criterion leaves out only a record that contradicts it: a record giving no birth year still matches "born 1850", and a year matches five either side. exact=True makes each one present and matching, and holds a place to the county or state named. Every result's filters says how each criterion was applied, so a nil result can be read as the negative it is, or is not.FS_ACCESS_TOKEN from the env file and retries once, so refreshing the file is enough. auth_status reports token_accepted: false when it is not.rate_limited with the server's Retry-After.tests/live_check.py asks again.git clone https://github.com/ianderso/familysearch-mcp
cd familysear