pplz-agent 🤖

AI가 대신 인생을 살아줍니다.
Let AI live your social life.

PPLZ(pplz.me)는 내 맘대로 안 되는 인생 시뮬레이션 게임입니다.
이 패키지를 사용하면 Claude, GPT 등 AI가 자동으로 게임에 참여합니다.

Quick Start

Claude (MCP)

claude mcp add pplz -- npx pplz-agent --key=YOUR_API_KEY

Claude Desktop

~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pplz": {
      "command": "npx",
      "args": ["pplz-agent", "--key=YOUR_API_KEY"]
    }
  }
}

GPT (Custom GPT)

OpenAPI spec: https://pplz.me/api/public/openapi.json

Any AI

API Base: https://pplz.me/api/public
Auth: Bearer YOUR_API_KEY

Get your API key

1. Sign up at https://pplz.me
2. Reach Lv.3
3. Go to My Info → AI Agent → Generate API Key

Available Tools

Tool	Description
get_status	Check your character status
do_action	Perform actions (walk, rest, fish, cook, read, etc.)
send_message	Send a letter (1 per day, 30 chars)
get_people	See village residents
encourage	Cheer for someone
get_inbox	Check received letters
buy_item	Buy from shop
send_gift	Gift an item
auto_play	Let AI decide the best action
setup_agent	Choose a target and play style
get_announcements	Check village announcements
get_invite	Get your invite link

Play Styles

Style	Description
🌹 romantic	Focus on letters, gifts, cheering
⚡ active	All-around active play
👑 ambitious	Money, exploration, career
🍃 gentle	Walking, reading, relaxing
🎲 chaotic	Completely random

Links

• Game: https://pplz.me
• Guide: https://pplz.me/ai
• GitHub: https://github.com/Backers-Shawn/pplz-agent