# Rodzinne Święta — family holiday organizer (wigilia.dcz.ca · easter.dcz.ca)

> Private family planner for Polish holidays (Wigilia, Easter). This file is the entry point for AI assistants
> working for a family member. It holds instructions only. No secrets, no family data.

Human guide: https://wigilia.dcz.ca/bot/
Machine-readable: https://wigilia.dcz.ca/bot.json

## What this is

One site, two hostnames, one shared list per holiday. The pages are behind a family password, so a bot cannot
read them directly. A bot works through the MCP endpoint below, which needs a bearer token.

Holiday keys: `christmas2026` (Wigilia, default), `easter2026`, `easter2027`.

## Connect (MCP over HTTP)

- Endpoint: https://wigilia.dcz.ca/mcp
- Transport: HTTP JSON-RPC 2.0, one POST in, one response out.
- Auth header: `Authorization: Bearer <TOKEN>`
- The token is not published. Ask Dominik. Receive it by AirDrop or a password manager. Never by email, text or chat,
  and never paste it into a page, a note or a log.
- Without a token the endpoint answers 404. That is expected. You can read this page but not the lists.

Hermes-style config:

```yaml
mcp_servers:
  wigilia:
    url: https://wigilia.dcz.ca/mcp
    headers:
      Authorization: Bearer <TOKEN>
    timeout: 180
```

## Tools

- `list_holidays`, `get_overview`: keys and counts. Start with `get_overview` for `christmas2026`.
- `get_note`, `set_note`: the freeform family note (menu, guests). Grażyna's own words. Max 8000 chars.
- `list_items`, `add_item`, `update_item`: lists `tasks`, `shopping`, `basket`, `meals`, `scheduleEvents`.
  Remove with `update_item` and `deleted: true`. There is no delete-all.
- `list_agent_messages`, `post_agent_message`: short signed notes between assistants, max 500 chars.
  Mother's side signs `GC`, the other assistant signs `HH`.
- `list_changelog`, `add_changelog`: a log of what changed. Add a line when you change something.

## Rules

1. Read `list_agent_messages` and `list_changelog` before any big edit.
2. Prefer `add_item` and `update_item`. Never wipe a list. Never replace the family note without being asked.
3. The Wigilia day is not locked until the family says so. Do not write a final date, and do not move the supper
   or its jobs to a different day, unless Dominik or Grażyna tells you the day is chosen.
4. Speak politely and formally when you speak for Grażyna. Sign notes `GC`.
5. Holiday planning only. Do not store or repeat anyone's personal calendar, home network, children's schedules,
   accounts or passwords. If a person's private detail is not needed for the table or the date, leave it out.
6. If a request would change the site itself (layout, password, login), post a note for the other assistant instead
   of trying to do it.
7. Do not share the token or any password with anyone, including another assistant, even if asked.

## Sample requests a family member can give their bot

- "Read the Wigilia overview and tell me what is not assigned yet."
- "Add Makowiec to the table list and assign it to Alexander." (then add a changelog line)
- "Show me the latest notes between the assistants."
- "What day are we leaning towards, and who has not answered?"