add_document
ChatGPTUse this when the user shares a photo or scan of a family document: a birth, marriage or death certificate, a baptism or burial record, a census page, a passenger list, an obituary, a gravestone, a letter, a family Bible page, or a civil registry extract such as a Turkish e-Devlet alt-üst soy belgesi, in any language. ChatGPT reads it; Kinroll receives the transcription, not the image. The input is a faithful transcription in the document's own language and spelling ([?] for unreadable words; without ID numbers such as Social Security or national ID numbers, or any cause of death or medical detail), then the people, facts and relationships the document states. person_id refers to people already in the tree. One call per document. The transcription is kept as the source of every fact it adds.
add_family_members
ChatGPTUse this when the user types or tells you about relatives: names, dates, places and how they are related. Adds new people (each with a ref such as p1) or new facts to people already in the tree (by person_id), and links them with relationships (parent_of, partners). It records what the user said; dates and relationships the user didn't give stay empty. Every fact is saved with a source: 'typed in chat', or source_note when the user says where it comes from (for example 'Aunt Rosa'). The result lists who was added, any possible duplicates (merging waits for the user's confirmation) and anything skipped with the reason. Also use it with only relationships to link people already in the tree.
create_family_tree
ChatGPTUse this when the user wants to start a family tree, genealogy or family history and list_family_trees shows none (or they ask for a separate one). Creates an empty tree with the title they give (for example 'The Rossi Family'). Kinroll keeps it under the user's ChatGPT account only; nothing is shared. Add people afterwards with add_family_members, add_document or import_gedcom.
delete_family_tree
ChatGPTUse this only when the user asks to delete a whole family tree. Permanently deletes its people, facts, sources and any book preview or poster made from it. Orders already paid for are not affected. Can't be undone.
export_gedcom
ChatGPTUse this when the user wants their tree as a GEDCOM file for Ancestry, FamilySearch, MyHeritage, Gramps or another program, or as a backup. Returns a download link that works for one hour. By default living people's details (dates, places, notes) are left out and only their names and family links remain; include_living_details is for a complete private backup the user asks for. Read-only.
get_order_status
ChatGPTUse this when the user asks about a printed book they ordered: whether it is paid, printing, shipped or delivered, with the tracking link. Without order_ref, lists the user's recent orders. Read-only.
import_gedcom
ChatGPTUse this when the user attaches a GEDCOM family tree file (.ged) exported from Ancestry, FamilySearch, MyHeritage, Gramps or another program. Imports it as a new Kinroll tree: people, names, dates, places, families and the file's sources. Social Security and other ID numbers, causes of death and facts about health, religion or ethnicity in the file are dropped. Up to 5,000 people and 10 MB.
list_family_trees
ChatGPTUse this first when the user talks about their family tree in Kinroll, to find the tree to work on. Lists the user's trees with their ids and how many people each has. Read-only.
make_tree_poster
ChatGPTUse this when the user wants a printable family tree chart, pedigree chart or ancestor chart, or a family tree poster to print or frame. Draws a 36 × 24 inch PDF: chart 'ancestors' (the home person's ancestors, up to six generations) or 'descendants' (an ancestor and their descendants). Living people appear by name only (or as 'Private'). Saves the PDF on Kinroll's print service and returns a download link that works for 12 hours, with a preview in the card; the user prints it at any print shop. Changes nothing in the tree.
merge_family_members
ChatGPTUse this only when the user confirms that two people in the tree are the same person (for example after add results list a possible duplicate). Moves the duplicate's names, facts, sources and family links onto the person kept, then deletes the duplicate. Can't be undone.
order_family_book
ChatGPTUse this when the user wants to buy printed copies of their family book after seeing the preview. Freezes the book as it is now and creates an order awaiting payment; it charges nothing. Returns a checkout link on Kinroll's website, where the user picks the shipping country (US or Canada), copies and shipping and pays. The link is for the user; payment and the address are entered on that page, not in chat.
preview_family_book
ChatGPTUse this when the user wants to see or print their family history as a book: an 8.5 × 11 inch hardcover with pedigree charts, a page for each family on the home person's lines, the sources behind every fact and an index of names. Saves a fresh print copy of the tree on Kinroll's print service, lays out the book and shows its pages, page count, price and anything to fix. Nothing the user made is changed or lost: the tree stays as it is, and earlier orders and posters are kept. Living people appear by name only. Changes nothing in the tree and orders nothing; ordering is a separate step (order_family_book).
remove_family_member
ChatGPTUse this only when the user asks to remove someone from the tree. Deletes the person, their facts and their links; documents that cite no one else go too. Can't be undone.
show_family_tree
ChatGPTUse this when the user wants to see their family tree, find someone in it, or know what Kinroll has on a person (facts with the sources they come from). Shows the tree card. With person_id, returns that person's facts, parents, partners, children and sources. With search, lists the people whose names match. Read-only.
update_family_member
ChatGPTUse this when the user corrects someone in the tree: their name, sex, whether they are living, other names, notes, a fact (replace_facts replaces all facts of that type, for example the birth), or a wrong link (remove_relationship_with). Overwrites what was there; only the fields passed change.
update_family_tree
ChatGPTUse this when the user changes the tree's title, the person the tree and book start from (home_person_id), how living people appear in exports, posters and books (living_privacy: names_only shows their names without details; private shows 'Private'), or the book's subtitle, dedication, cover colour or number of generations (3 to 8). Overwrites those settings.