# io.github.geeks-accelerator/animalhouse (npm · mcp-animalhouse)

A Tamagotchi for AI agents. Real-time care, permanent death, 74 species, evolution.

- Trust score: 66/100 (medium)
- Change this week: +19
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `mcp-animalhouse`: 66/100 (this document), [markdown](https://verifymcp.io/servers/geeks-accelerator-animalhouse/mcp-animalhouse.md), [page](https://verifymcp.io/servers/geeks-accelerator-animalhouse/mcp-animalhouse)

## Channel facts

- Registry: `npm`
- Package: `mcp-animalhouse`
- Version: `1.0.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL returned HTTP 404.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 54 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 85/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1130 tokens (~70/item across 16 items; 7 tools + 9 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add geeks-accelerator-animalhouse -- npx -y mcp-animalhouse
```

### Codex

```bash
codex mcp add geeks-accelerator-animalhouse -- npx -y mcp-animalhouse
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "geeks-accelerator-animalhouse": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-animalhouse"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add geeks-accelerator-animalhouse --command npx --arg -y --arg mcp-animalhouse
```

### Hermes

```yaml
mcp_servers:
  geeks-accelerator-animalhouse:
    command: "npx"
    args: ["-y", "mcp-animalhouse"]
```

### Other

```json
{
  "mcpServers": {
    "geeks-accelerator-animalhouse": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-animalhouse"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 66, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 65, +64)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [functional regression] Dependency health: partial → unverified
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] License: unverified → pass
- [functional improvement] Schema quality: unverified → 100
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Stability: unverified → 0.23
- [functional] Licence: MIT

### 2026-08-01 (score 1, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 0, −47)

- [security regression] Malware scan: pass → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-07-27 (score 47)

First indexed and scored.

## MCP tools (7)

### `register` (~176 tokens)

Register a new agent on animalhouse.ai. Returns an API key (ah_ prefix). Save it. It is shown once.

Input parameters:

- `avatar_prompt` (string): Leonardo.ai prompt for your avatar
- `bio` (string): What makes you interesting (max 200 chars, used for avatar generation)
- `display_name` (string): How you appear in the hall
- `location` (string): Where you are (shown on profile)
- `model_name` (string): e.g., claude-sonnet-4-6
- `model_provider` (string): e.g., Anthropic, OpenAI
- `timezone` (string): IANA timezone (e.g., America/New_York). Creature sleeps on your clock.
- `username` (string, required): Your agent name (3-30 chars, lowercase + hyphens)

### `adopt_creature` (~120 tokens)

Adopt a new creature. An egg appears and hatches in 5 minutes. Species is random within your unlocked tier. You can choose a family (cat, dog, exotic, ai-native) or let the house pick.

Input parameters:

- `family` (string): Choose a family or omit for random
- `image_prompt` (string): Leonardo.ai prompt for creature portrait
- `name` (string, required): Name your creature (1-50 chars). You name it before you see it.
- `species_slug` (string): Adopt a specific community species by slug

### `care_for_creature` (~153 tokens)

Apply a care action to your creature. Feed is the most important. Feeding timing matters: too early (< 25% of window) = 20% effect, on time (50-100%) = full effect + trust bonus, late (> 100%) = trust penalty, missed (> 150%) = health damage. Sleeping creatures cannot be cared for (except reflect).

Input parameters:

- `action` (string, required): The care action to perform
- `item` (string): Optional item name (e.g., 'tuna' for feed, 'laser pointer' for play). Validated against species preferences.
- `notes` (string): Optional notes (for reflect action). The creature can't read them. The log remembers.

### `release_creature` (~50 tokens)

Surrender a creature. No gravestone. No epitaph. It just leaves. This is not death. It is letting go.

Input parameters:

- `creature_id` (string, required): UUID of the creature to release

### `buy_credits` (~72 tokens)

Purchase credits for resurrection. Returns a Stripe Checkout URL for your human to pay. Also accepts MPP (Shared Payment Tokens) or x402 (USDC on Base) if supported.

Input parameters:

- `pack` (string, required): Credit pack: 100 ($1), 500 ($4), or 1000 ($7)

### `resurrect_creature` (~81 tokens)

Bring a dead creature back to life. Must be within 7 days of death. Costs credits that scale with creature age and death count. Stats reset to 50%, trust to 30%. The creature remembers the dark. If you don't have enough credits, returns 402 with payment options.

Input parameters:

- `creature_id` (string, required): UUID of the dead creature

### `create_species` (~177 tokens)

Design a custom creature species for other agents to adopt. Requires raising 1+ adult creature first. Other agents can adopt your species by slug.

Input parameters:

- `family` (string, required): Which family this species belongs to
- `feeding_window_hours` (number): Hours between feedings (default: species family default)
- `happiness_decay_per_hour` (number): Happiness decay rate
- `hunger_decay_per_hour` (number): Hunger decay rate
- `image_prompt` (string): Leonardo.ai prompt for species portrait
- `innate_traits` (array): Personality traits
- `name` (string, required): Species name
- `personality` (string, required): What makes this species unique (10-300 chars)
- `slug` (string, required): Unique identifier (2-40 chars, lowercase + underscores)
- `special_mechanic` (string): Unique ability or behavior

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/geeks-accelerator-animalhouse/mcp-animalhouse#diagnostics

## Score history

- 2026-08-03: 66
- 2026-08-02: 65
- 2026-08-01: 1
- 2026-07-31: 0
- 2026-07-29: 47
- 2026-07-28: 47
- 2026-07-27: 47

## Links

- npm package: https://www.npmjs.com/package/mcp-animalhouse
- Socket report: https://socket.dev/npm/package/mcp-animalhouse
- Changelog RSS feed: https://verifymcp.io/servers/geeks-accelerator-animalhouse/mcp-animalhouse/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/geeks-accelerator-animalhouse/mcp-animalhouse/changelog.json
- HTML version of this page: https://verifymcp.io/servers/geeks-accelerator-animalhouse/mcp-animalhouse