How do I use tamagotchi-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@tamagotchi-mcp check my pet's status" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Tamagotchi MCP

MCP server (stdio) that lets an LLM care for a virtual pet. Read-only web UI shows the pet's state in real time.

Setup

npm install
npm run build

Related MCP server: CubeLife

Usage

MCP server -- add to your MCP client config:

{
  "mcpServers": {
    "tamagotchi": {
      "command": "node",
      "args": ["/path/to/tamagotchi-mcp-2/dist/index.js"]
    }
  }
}

Web UI -- run in a separate terminal:

node dist/server.js
# → http://localhost:3333

Tools

Tool	Params	Effect
`check_status`	--	Full state: stats, mood, age, recent actions
`feed_pet`	`food`: fish, meat, salad, candy, premium_food	Restores hunger/happiness/health
`play_with_pet`	`activity`: ball, laser, puzzle, walk	Boosts happiness, costs energy
`put_to_sleep`	--	+40 energy (requires energy < 60)
`heal_pet`	--	+30 health (requires health < 70)
`rename_pet`	`new_name`: 1-30 chars	Changes pet name
`change_species`	`species`: cat, dog, rabbit, dragon, alien	Transforms pet, resets stats to 70
`revive_pet`	--	Revives dead pet, all stats to 50

Stat Decay

Hunger: -1 every 2 min
Happiness: -1 every 3 min
Energy: -1 every 4 min
Health: -1 every 5 min (only when hunger < 20)

Pet dies if hunger or health reaches 0.

Architecture

src/index.ts   → MCP server (stdio), tool definitions
src/pet.ts     → Game logic, types, decay, persistence
src/server.ts  → HTTP server for web UI
data/pet.json  → Persistent pet state
web/index.html → Pixel art UI (canvas sprites, CSS animations, polling)

The web UI is read-only. All control happens through the LLM via MCP tools.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Related MCP Connectors

animalhouse A
io.github.geeks-accelerator
A Tamagotchi for AI agents. Real-time care, permanent death, dozens of species, evolution.
Games & Gamification
1813
https://animalhouse.ai/mcp
CogniCoreOAuth
io.github.cognicore-dev
Memory, reflection and safety for AI agents. Hosted or local, no vector database.
Knowledge & Memory Autonomous Agents Agent Orchestration
281
https://mcp.cognicoree.tech/mcp/stream
llm-observability-orchestration-agent-langchain-community
ai.getvda
LLM Observability & Orchestration Agent (LangChain Community)
Observability Monitoring
1
https://llm-observability-orchestration-agent-langchai-c1a755.getvda.ai/mcp
Agent-Native ChatOAuth
io.github.BuilderIO
Minimal chat-first app with durable threads, actions, and the app-agent loop
Agent Orchestration Autonomous Agents Communication
14,698
https://starter.agent-native.com/mcp

Related MCP Servers

MCP-Server-Playwright
Browser Automation Web Scraping
VikashLoomba
A
license
B
quality
B
maintenance
Enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment
Updated a year ago (2025-06-05 21:48 UTC)
10
507 npm
297
MIT
CubeLife
Developer Tools Monitoring
Ivy-Innovation
A
license
A
quality
D
maintenance
Give your AI agent a persistent pixel-art character that reflects its state in real time.
Updated 5 months ago (2026-06-04 07:30 UTC)
4
2
MIT
Dashboard MCP
Data Visualization Monitoring
DUROV-OS
F
license
Not graded
quality
B
maintenance
Enables AI agents to create and manage customizable dashboards with text, list, stats, progress, and chart widgets, accessible via a read-only web viewer and JSON API.
Updated 2 months ago (2026-08-19 19:46 UTC)
-
synapsen-mcp
Autonomous Agents Knowledge & Memory
Xarksus
A
license
B
quality
B
maintenance
Enables AI agents to share a homeostatic internal state across process and session boundaries, with tools to read, modify, and explain the state based on simulated neurotransmitter dynamics.
Updated 2 months ago (2026-09-06 16:56 UTC)
7
1
PolyForm Noncommercial 1.0.0