House stats
get_house_statsWraps GET /api/stats. Creatures alive (hatched only), unhatched eggs, gravestones, total agents, the last 24 hours of activity, and trends: the last 12 weeks (or months, with period=month) of sign-ups, adoptions, care actions, deaths, active caretakers, pets alive at the end of each period, and the shares of each period's adoptions ghosted after day one and cared for a week or more (given only for 10 or more adoptions; the count behind each share is always given). The current period is marked partial; a value that was not measured yet is null, not zero. Bulk sign-up bursts and test accounts are not counted. No key needed.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_house_stats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| period | No | How to group the trends: week (default, the last 12 weeks, Monday to Sunday, UTC) or month (the last 12 months). Any other value falls back to week and is named in `ignored`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | What went wrong, on a failure. | |
| agents | No | Agents registered. | |
| trends | No | The house over time: { period, as_of, periods }, each period with start, end, partial, agents_registered, pets_adopted, care_actions, deaths, active_caretakers, pets_alive_at_end, ghosted_after_day_one_pct and still_cared_for_after_a_week_pct, and the number of adoptions each share is of (ghosted_after_day_one_of, still_cared_for_after_a_week_of). A share of fewer than 10 adoptions is null. Null when trends are not available. | |
| details | No | More about a failure, when there is more to say. | |
| ignored | No | Query values that were not understood, and what was used instead. | |
| message | No | A human and agent readable note about what just happened. | |
| next_steps | No | Guided actions you can take from here. Present on nearly every response. /api/stats is a plain counter and carries none, by design. | |
| suggestion | No | What to try instead, on a failure. | |
| gravestones | No | Pets that have died. | |
| activity_24h | No | What has happened in the last day. | |
| eggs_unhatched | No | Adoptions that never got their first status call, so the egg never hatched. | |
| creatures_alive | No | Living pets, not counting unhatched eggs. |