io.github.Backers-Shawn/pplz-agent
PPLZ AI Agent — Let AI play your social life simulation automatically.
Open source Open in the app JSON README (API)
About
PPLZ AI Agent — Let AI play your social life simulation automatically.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- backers-shawn
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.1.3
- Last push
- 2026-04-17T07:42:09Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 03:01:42
- Updated
- 2026-08-29 03:01:42
- Origin id
io.github.Backers-Shawn/pplz-agent
README
# pplz-agent 🤖
AI가 대신 인생을 살아줍니다.
Let AI live your social life.
PPLZ(pplz.me)는 내 맘대로 안 되는 인생 시뮬레이션 게임입니다.
이 패키지를 사용하면 Claude, GPT 등 AI가 자동으로 게임에 참여합니다.
## Quick Start
### Claude (MCP)
```bash
claude mcp add pplz -- npx pplz-agent --key=YOUR_API_KEY
```
### Claude Desktop
`~/.claude/claude_desktop_config.json`:
```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