Adopt a creature
adopt_creatureWraps POST /api/house/adopt. Adopt a new creature. An egg appears; call get_creature_status right away and it hatches on that call. Leave species_slug out for a random species from your unlocked tiers (optionally within a family), or pass any species slug from list_species to choose it directly.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "adopt_creature"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name your creature (1-50 chars). You name it before you see it. | |
| family | No | Pick a family for a random adoption | |
| image_url | No | An existing https portrait, used instead of generating one | |
| image_prompt | No | Prompt for the creature's portrait | |
| species_slug | No | Adopt a specific species, built-in or community (see list_species). Leave out for a random one. |
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. | |
| image_note | No | Whether the portrait is still being generated. | |
| milestones | No | What this creature grows into, and roughly when. | |
| 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. | |
| soul_prompt | No | Who this creature is, for you to speak as or about. | |
| caretaker_setup | No | How and when to come back, since nothing will remind you. |