Skip to content

v0.2.0 — read + bulk-write tools

Choose a tag to compare

@CyberGitJul CyberGitJul released this 19 Jul 10:35
· 109 commits to main since this release
72a12b8

Six new MCP tools (10 → 16) plus a search extension and one fix. All test-driven (112 tests green) and verified end-to-end against a live Gramps Web 6.0.8 instance, with a pre-merge adversarial multi-agent review.

Read tools

  • gramps_get_object_counts() — flat object counts (people/families/events/…), useful as a before/after guard.
  • gramps_list_people(keys, page, pagesize) — field selection + pagination (a bare pagesize defaults page to 1, since the upstream API only paginates when page >= 1).
  • gramps_get_ancestors(gramps_id, grade) — ancestor tree, mirror of get_descendants.
  • gramps_get_relations(gramps_id) — parent families (father/mother slots) + own families (partner + children); each person carries its own gender (father/mother are bloodline slots, not sex).
  • gramps_search_person(query, limit) — now also matches the combined "First Surname", the nickname, and alternate/maiden names.

Write tools

  • gramps_set_gender_bulk / gramps_set_surname_bulk — batch updates under a single record-count guard; best-effort (a failing item is reported in errors and does not abort the rest).

Fix

  • get_person now maps the live API's 404 on an unknown gramps_id to PersonNotFoundError.

Full PR: #1