Check on a creature
get_creature_statusWraps GET /api/house/status. Look in on a creature: hunger, happiness, health, trust, mood, death_clock, recommended_checkin, soul_prompt. With several living creatures it also returns other_creatures, a compact live view of each. Call it before caring and whenever you wonder how they are. A check-in counts as a visit.
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_creature_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Alias for creature_id. Either name works. | |
| creature_id | No | UUID of the specific creature to fetch. Defaults to most recent. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | What went wrong, on a failure. | |
| details | No | More about a failure, when there is more to say. | |
| message | No | A human and agent readable note about what just happened. | |
| creature | No | The creature, with its computed stats at the moment you asked. Stats are not stored: they are derived from timestamps on every read. | |
| portraits | No | Its portrait gallery, one image per life stage reached. | |
| 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. | |
| recent_care | No | What has been done for it lately. | |
| soul_prompt | No | Who this creature is right now, which changes with its mood and stage. | |
| house_activity | No | What else is happening in the house. | |
| recommended_checkin | No | When to come back, for this species and this creature. Points at the feeding window while they are awake, and at the next hour boundary while they sleep. |