# FamilySearch API MCP for AI Agents AI Agent Connect > FamilySearch API lets your AI agent dig through the world's largest family history database. It pulls person details, pedigree charts, and historical records directly into your chat. Stop hunting through endless web pages and start asking questions about your ancestry in plain English. ## Overview - **Category:** knowledge-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_NBvLpXdOI5ehLMBDuWXjBbjUwW8SLFHFZoz8epVV/ai-agent-connect - **Tags:** genealogy, ancestry, historical-records, pedigree-charts, research-automation ## Description This Connector provides a direct connection to the world's largest family history database. Researching family history usually feels like a full-time job of clicking through infinite tabs and squinting at blurry records. You spend hours trying to connect a name in one place to a birth certificate in another. It is a manual slog that makes it easy to lose your place or miss a key connection. This connection changes that by letting your AI client do the heavy lifting. Instead of manual searching, you can just ask your agent to find a specific ancestor or pull up a pedigree chart. It handles the tedious work of querying global trees and listing historical collections so you can focus on the actual story of your lineage. Because Vinkius hosts this connection, you can plug it into your favorite tools and get started immediately. You will get a conversational interface for your research where the agent acts like a personal genealogist who knows where every record is hidden. It is about moving from asking where to find a document to actually seeing the data. You can audit pedigrees, find memories, and list collections with a few words. It turns a mountain of data into a clear, readable summary for your records. You can quickly move from a broad search to a specific individual's biography, pulling in photos and stories that make the history feel real. This is about getting answers without the friction of navigating complex web interfaces. You can stop worrying about the technical details of database queries and start focusing on the people who came before you. It makes the process of building a family tree feel like a conversation rather than a chore. ## Tools ### get_person_memories Pulls photos and stories tied to a specific person. This helps you see the personal side of your history. ### get_person_pedigree Retrieves the full ancestry chart for a given individual. Use this to map out multi-generational lineages quickly. ### get_person_details Gets full name, dates, and locations for a person by their unique ID. This ensures you have the correct metadata for your records. ### list_historical_collections Shows all available historical records on the platform. This helps you understand the scope of available archives. ### check_api_status Verifies that your API connection is active and working. Use this to troubleshoot your connection issues quickly. ### search_persons Searches the global family tree for specific names or details. This is the fastest way to find new leads in your research. ## Prompt Examples **Prompt:** ``` Find a person named 'Mary Higgins' born in 1850 in Ireland. ``` **Response:** ``` I've found several matches for Mary Higgins born in Ireland around 1850. The most likely match is: **Mary Higgins** * **Birth:** ~1850, County Cork, Ireland * **Death:** 1912, New York, USA * **Notes:** Records indicate she immigrated in 1882. Would you like to see her full pedigree or the memories associated with her? ``` **Prompt:** ``` Show me the pedigree for person ID 'KWCX-S58'. ``` **Response:** ``` I've retrieved the ancestry chart for **KWCX-S58**. Here is the lineage for the last three generations: | Generation | Relation | Name | Vital Dates | | --- | --- | --- | --- | | 1 | Father | Thomas Higgins | 1820-1890 | | 1 | Mother | Sarah Higgins | 1825-1895 | | 2 | Grandfather | William Higgins | 1795-1860 | | 2 | Grandmother | Martha Higgins | 1798-1865 | Would you like the IDs for any of these ancestors? ``` **Prompt:** ``` What memories are there for person ID 'LZDP-H7Z'? ``` **Response:** ``` I've identified 5 memories for this individual: * **Photos:** 3 portrait photos (1920s era) * **Documents:** 2 historical documents (Marriage certificate, Deed) * **Stories:** 1 written memoir regarding their time in the Great War. I can provide the specific metadata for any of these items if you'd like. ``` ## Capabilities ### Pull specific ancestor details Get names, dates, and locations for individuals in the global family tree. ### View full ancestry charts Retrieve multi-generational pedigree charts for any person ID. ### Find associated photos and stories Identify and pull memories like portraits and documents tied to a person. ### Browse global historical records List all available record collections on the platform to see what's available. ### Check connection status Verify that your API connection is active and ready for queries. ### Search millions of family tree entries Search the global database for specific names and life events. ## Use Cases ### Finding a specific relative A user asks for 'John Smith' born in 1850 in Ireland. The agent uses `search_persons` to find matches and then provides the most likely candidate with their birth and death details. ### Mapping a lineage A researcher wants to see the 3-generation tree for a specific ID to see where the line branches. They ask the agent to pull the pedigree and get the names of all ancestors. ### Finding old photos A user has a name but wants to see if there are any scanned portraits or stories attached. The agent uses `get_person_memories` to list all associated items. ### Archive research A librarian wants to see which collections cover 'Civil War records' to guide a student. They ask the agent to list the historical collections available on the platform. ## Benefits - Stop manual searching with `search_persons` to find matches instantly. You can ask your agent to scan millions of family tree entries for specific names and dates, getting back a curated list of results without clicking through pages of search results. - See clear lineage paths using `get_person_pedigree` to map out generations. This allows you to visualize how branches of your family tree connect across multiple centuries in a single view. - Gather visual history with `get_person_memories` to see photos and documents. You can quickly pull in portraits and stories that make your research feel personal rather than just a list of dates. - Navigate archives easily with `list_historical_collections` to see what's available. This helps you understand the scope of global archives and which record types are available for your specific search. - Get precise data with `get_person_details` to avoid confusing your ancestors. Use this to pull specific vital dates and locations to ensure your records remain accurate and verified. - Verify your connection status with `check_api_status` to keep your workflow moving. This ensures your agent always has a live link to the data you need for your research. ## How It Works The bottom line is you get a conversational gateway to the world's largest genealogy database. 1. Get your FamilySearch Access Token from the developer portal. 2. Add this Connector to your AI client and paste your token in the settings. 3. Ask your agent to find people, show pedigrees, or list records in plain English. ## Frequently Asked Questions **Can I use the FamilySearch API to find my ancestors?** Yes, this Connector lets your AI agent search the global family tree for you. You can ask for specific names and dates, and it will pull back the most relevant matches. **How does the FamilySearch API help with pedigree charts?** It pulls the actual ancestry tree for a specific person. You can ask your agent to show you a multi-generational view of a lineage without having to build it yourself. **Can I see photos with the FamilySearch API?** Yes, it pulls memories like photos, stories, and documents tied to a person. Your agent can list these for you so you can see the visual side of your history. **Is the FamilySearch API good for professional historians?** Yes, it automates the audit of records and metadata. It's a great way for historians to quickly pull data from the world's largest family history database into a research workflow. **Can I see which historical records are available?** Yes, you can ask your agent to list all the historical record collections available on the platform. This helps you see what kind of archives are available for your research. **Do I need to be an expert to use the FamilySearch API?** No, you don't need any technical skills. You just talk to your AI client in plain English, and it handles the database queries and data retrieval for you. **How do I find my FamilySearch Access Token?** Log in to the [**FamilySearch Developer portal**](https://www.familysearch.org/developers/), and you can generate a Personal Access Token or use the OAuth flow to obtain one. Copy and paste it below. **Can the agent show my family tree?** Yes. Use the `get_person_pedigree` tool providing a starting person ID. Your agent will return the ancestry chart metadata instantly. **Are photos and stories included?** Yes. The `get_person_memories` tool retrieves any photos, stories, and documents (memories) associated with a specified person in the tree.