Zovo Genogram
Turns a list of people and relationships into a genogram with the standard symbols.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"genogram": {
"url": "https://genogram.zovo.one/mcp"
}
}
}Remote endpoints
https://genogram.zovo.one/mcpstreamable-httpWhat it can do
Tool inventory
Tools (2)
🟢make_genogram(people, relations, household, title, page_size)
Use this when the user wants a genogram or family diagram with standard symbols drawn from people and their relationships, for example "draw a genogram of my family" or "make a three-generation genogram for my social work class". Takes people (id, name, sex, birth and death years, deceased, index person; no label or notes), relations (couple: married, divorced, separated, cohabiting, engaged; parent_child: biological, adopted, foster; twins: identical, fraternal; emotional: close, distant, conflict, cut_off, hostile), an optional household, a title and a page size. Returns counts, each person's generation number, a geometry check (overlapping symbols or names, family lines through a name), the legend of symbols used, an interactive chart, and PDF, SVG, people CSV and relationships CSV downloads. An emotional relationship is drawn as a line only between two people next to each other in the same row; all others, including any between a parent and a child, are listed in a "Relationships not drawn" table and are not in the legend. Refuses unknown ids, parent cycles, more than 2 biological parents and impossible years, naming the problem. Up to 150 people, 12 generations and 100 emotional relationships. Relationships only: does not take health or medical details. Download links of large charts expire after about 1 hour.
Input Schema
{
"type": "object",
"properties": {
"people": {
"maxItems": 2000,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 400,
"description": "Short unique id, up to 40 characters, used in relations, e.g. \"p1\" or \"maria\"."
},
"name": {
"type": "string",
"maxLength": 400,
"description": "Name shown under the symbol, up to 60 characters, e.g. \"Maria Kowalska\"."
},
"sex": {
"description": "M (square), F (circle), X (diamond) or unknown (diamond with ?). Default unknown.",
"type": "string",
"enum": [
"M",
"F",
"X",
"unknown"
]
},
"birth_year": {
"description": "4-digit birth year, e.g. 1958.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"death_year": {
"description": "4-digit death year, e.g. 2019. Marks the person as deceased.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"deceased": {
"description": "true draws an X through the symbol when the death year is not known.",
"type": "boolean"
},
"index": {
"description": "true for the index person (the person the genogram is about); drawn with a double line. At most one.",
"type": "boolean"
}
},
"required": [
"id",
"name"
],
"additionalProperties": {}
},
"description": "The people, up to 150. Example: [{\"id\":\"p1\",\"name\":\"Jan\",\"sex\":\"M\",\"birth_year\":1950},{\"id\":\"p2\",\"name\":\"Ewa\",\"sex\":\"F\",\"birth_year\":1952},{\"id\":\"p3\",\"name\":\"Ola\",\"sex\":\"F\",\"birth_year\":1980,\"index\":true}]."
},
"relations": {
"description": "The relationships, up to 600 (at most 150 couples and 100 emotional). Example: [{\"type\":\"couple\",\"a\":\"p1\",\"b\":\"p2\",\"kind\":\"married\",\"start_year\":1975},{\"type\":\"parent_child\",\"a\":\"p1\",\"b\":\"p3\"},{\"type\":\"parent_child\",\"a\":\"p2\",\"b\":\"p3\"}].",
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"couple",
"parent_child",
"twins",
"emotional"
],
"description": "couple, parent_child (a is the parent, b the child), twins, or emotional."
},
"a": {
"type": "string",
"maxLength": 400,
"description": "Person id. For parent_child this is the parent, e.g. \"p1\"."
},
"b": {
"type": "string",
"maxLength": 400,
"description": "Person id. For parent_child this is the child, e.g. \"p3\"."
},
"kind": {
"description": "couple: married (default), divorced, separated, cohabiting, engaged. parent_child: biological (default), adopted, foster. twins: identical, fraternal (default). emotional: close (default), distant, conflict, cut_off, hostile.",
"type": "string",
"maxLength": 40
},
"start_year": {
"description": "Year a couple married or began, e.g. 1981.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"end_year": {
"description": "Year a couple divorced, separated or ended, e.g. 1995.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"type",
"a",
"b"
]
}
},
"household": {
"description": "Ids of the people who live together; drawn with a dashed outline, e.g. [\"p2\",\"p3\"].",
"maxItems": 2000,
"type": "array",
"items": {
"type": "string",
"maxLength": 400
}
},
"title": {
"description": "Title printed on the chart and used in file names, up to 80 characters, e.g. \"Kowalski family\".",
"type": "string",
"maxLength": 400
},
"page_size": {
"description": "PDF page: letter (default), a4, tabloid, a3 or a2. One page when the whole chart fits with text of at least 6 pt; else the chart prints in overlapping parts at full size.",
"type": "string",
"enum": [
"letter",
"a4",
"tabloid",
"a3",
"a2"
]
}
},
"required": [
"people"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"title": {
"type": "string"
},
"counts": {
"type": "object",
"properties": {
"people": {
"type": "number"
},
"relationships": {
"type": "number"
},
"couples": {
"type": "number"
},
"parent_links": {
"type": "number"
},
"twin_links": {
"type": "number"
},
"emotional": {
"type": "number"
},
"generations": {
"type": "number"
},
"errors": {
"type": "number"
},
"warnings": {
"type": "number"
}
},
"required": [
"people",
"relationships",
"couples",
"parent_links",
"twin_links",
"emotional",
"generations",
"errors",
"warnings"
],
"additionalProperties": false
},
"generation_rule": {
"type": "string"
},
"people": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"checks": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"pdf": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"legend": {
"type": "array",
"items": {
"type": "string"
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"downloads": {
"type": "object",
"properties": {
"pdf": {
"type": "string"
},
"svg": {
"type": "string"
},
"csv": {
"type": "string"
},
"relations_csv": {
"type": "string"
}
},
"additionalProperties": false
},
"shown": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"title",
"counts",
"generation_rule",
"people",
"checks",
"pdf",
"legend",
"warnings",
"downloads"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢check_genogram(people, relations, household)
Use this when the user wants a family list checked before drawing a genogram, for example "check my genogram data for mistakes" or "which generation is each person in". Takes the same people, relations and household as make_genogram. Returns the problems found (unknown or duplicate ids, a person who is their own ancestor with the cycle named, more than 2 biological parents, a parent who is not older than the child, couple years outside a partner's life, twins with different parents, too many generations; above 150 people it checks the first 150 and names the people left out), warnings, and each person's generation number when the data is consistent. Draws nothing and makes no files. Relationships only: it does not take health or medical details.
Input Schema
{
"type": "object",
"properties": {
"people": {
"maxItems": 2000,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 400,
"description": "Short unique id, up to 40 characters, used in relations, e.g. \"p1\" or \"maria\"."
},
"name": {
"type": "string",
"maxLength": 400,
"description": "Name shown under the symbol, up to 60 characters, e.g. \"Maria Kowalska\"."
},
"sex": {
"description": "M (square), F (circle), X (diamond) or unknown (diamond with ?). Default unknown.",
"type": "string",
"enum": [
"M",
"F",
"X",
"unknown"
]
},
"birth_year": {
"description": "4-digit birth year, e.g. 1958.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"death_year": {
"description": "4-digit death year, e.g. 2019. Marks the person as deceased.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"deceased": {
"description": "true draws an X through the symbol when the death year is not known.",
"type": "boolean"
},
"index": {
"description": "true for the index person (the person the genogram is about); drawn with a double line. At most one.",
"type": "boolean"
}
},
"required": [
"id",
"name"
],
"additionalProperties": {}
},
"description": "The people, up to 150. Example: [{\"id\":\"p1\",\"name\":\"Jan\",\"sex\":\"M\",\"birth_year\":1950},{\"id\":\"p2\",\"name\":\"Ewa\",\"sex\":\"F\",\"birth_year\":1952},{\"id\":\"p3\",\"name\":\"Ola\",\"sex\":\"F\",\"birth_year\":1980,\"index\":true}]."
},
"relations": {
"description": "The relationships, up to 600 (at most 150 couples and 100 emotional). Example: [{\"type\":\"couple\",\"a\":\"p1\",\"b\":\"p2\",\"kind\":\"married\",\"start_year\":1975},{\"type\":\"parent_child\",\"a\":\"p1\",\"b\":\"p3\"},{\"type\":\"parent_child\",\"a\":\"p2\",\"b\":\"p3\"}].",
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"couple",
"parent_child",
"twins",
"emotional"
],
"description": "couple, parent_child (a is the parent, b the child), twins, or emotional."
},
"a": {
"type": "string",
"maxLength": 400,
"description": "Person id. For parent_child this is the parent, e.g. \"p1\"."
},
"b": {
"type": "string",
"maxLength": 400,
"description": "Person id. For parent_child this is the child, e.g. \"p3\"."
},
"kind": {
"description": "couple: married (default), divorced, separated, cohabiting, engaged. parent_child: biological (default), adopted, foster. twins: identical, fraternal (default). emotional: close (default), distant, conflict, cut_off, hostile.",
"type": "string",
"maxLength": 40
},
"start_year": {
"description": "Year a couple married or began, e.g. 1981.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"end_year": {
"description": "Year a couple divorced, separated or ended, e.g. 1995.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"type",
"a",
"b"
]
}
},
"household": {
"description": "Ids of the people who live together; drawn with a dashed outline, e.g. [\"p2\",\"p3\"].",
"maxItems": 2000,
"type": "array",
"items": {
"type": "string",
"maxLength": 400
}
}
},
"required": [
"people"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"ready": {
"type": "boolean"
},
"counts": {
"type": "object",
"properties": {
"people": {
"type": "number"
},
"relationships": {
"type": "number"
},
"couples": {
"type": "number"
},
"parent_links": {
"type": "number"
},
"twin_links": {
"type": "number"
},
"emotional": {
"type": "number"
},
"generations": {
"type": "number"
},
"errors": {
"type": "number"
},
"warnings": {
"type": "number"
}
},
"required": [
"people",
"relationships",
"couples",
"parent_links",
"twin_links",
"emotional",
"generations",
"errors",
"warnings"
],
"additionalProperties": false
},
"generation_rule": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"people": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"people_left_out": {
"type": "array",
"items": {
"type": "string"
}
},
"people_left_out_count": {
"type": "number"
},
"limits": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"shown": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"ready",
"counts",
"generation_rule",
"issues",
"people",
"limits"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Evidence