How to Use the FamilySearch API MCP in Mastra AI

Build reliable genealogical research workflows with Mastra AI and the FamilySearch API.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect FamilySearch API MCP to Mastra AI

Create your Vinkius account to connect FamilySearch API to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup FamilySearch API with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated research cycles with Mastra AI

Chain `search_persons` and `get_person_details` inside your Mastra agents to build recursive search workflows. The agent handles the discovery process while you define the success criteria. If the API returns a 429 error, the framework automatically triggers a retry. This keeps your research pipeline running without manual intervention.

Conditional pedigree expansion

Use `get_person_pedigree` inside a workflow to determine if an ancestor needs further research. If the tree is incomplete, the agent branches to pull more historical data. This logic keeps your API usage efficient. You only fetch deep records when the initial scan indicates a gap in the lineage.

Historical collection auditing

Deploy an agent to `list_historical_collections` and verify record availability for specific regions. It is a simple way to validate if your research path is viable before starting. Integrate this into your deployment pipeline to ensure your agents aren't wasting cycles on empty databases. It acts as a pre-flight check for your genealogical operations.

Setup guide

Set up FamilySearch API MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All FamilySearch API tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "familysearch-api-mcp-client",
  servers: {
    "familysearch-api-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "FamilySearch API Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to FamilySearch API tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent FamilySearch API transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by FamilySearch API. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect FamilySearch API now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about FamilySearch API MCP in Mastra AI

Mastra AI uses built-in exponential backoff for all MCP tools. If the API throttles your connection, the agent waits and tries again automatically.

You can set up a workflow that monitors specific pedigrees. When the agent finds a new record, it notifies your admin or logs the change.

Yes, you can use the output of any tool as a decision point. If a search yields no results, the agent can switch to a different historical collection.

The server uses endpoint tokens for secure access. You pass these into your agent configuration to keep the connection private and authenticated.

The server processes person identifiers, pedigree structures, and historical record metadata. All communication is encrypted and the session state is cleared after each run.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript