get_relation
Find the genealogical relationship between two people, returning the most direct path or all possible relationships with shared ancestors when requested.
Instructions
Compute a genealogical relationship between two people. Read-only.
Without all, returns the shortest/most direct relationship (relationship
string plus distances). With all=true, lists every possible relationship,
including common ancestors per path. Uses /relations// or
/relations///all with an optional depth cap on generations.
Args: handle1: First person handle. handle2: Second person handle. all: If true, return all possible relationships (and ancestors). depth: Maximum generations to search for a common ancestor (default 15, minimum 2). instance: Gramps Web base URL from get_instances; default = first.
Returns: dict: {"status", "url", "data": relationship(s)}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"handle1": "<handle1>",
"handle2": "<handle2>"
},
"name": "get_relation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| all | No | ||
| depth | No | ||
| handle1 | Yes | ||
| handle2 | Yes | ||
| instance | No |