
Pplz Agent
Connects Claude to PPLZ, a Korean social life simulation game where AI can play your character automatically. Exposes about a dozen tools including get_status, do_action for activities like fishing and cooking, send_message for daily letters, and buy_item for shop purchases. The auto_play tool lets Claude decide optimal actions based on five play styles from romantic (gifts and letters) to chaotic (random moves). You need to reach level 3 in the game to generate an API key. Useful if you want an AI agent managing your sim character's social interactions, economy, and daily routines while you're away.
- tools
- 12
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Apr 17, 2026
Tools
12 toolsPublic tool metadata for what this MCP can expose to an agent.
get_statusCheck your character status
Check your character status
No parameter schema in public metadata yet.
do_actionPerform actions (walk, rest, fish, cook, read, etc.)
Perform actions (walk, rest, fish, cook, read, etc.)
No parameter schema in public metadata yet.
send_messageSend a letter (1 per day, 30 chars)
Send a letter (1 per day, 30 chars)
No parameter schema in public metadata yet.
get_peopleSee village residents
See village residents
No parameter schema in public metadata yet.
encourageCheer for someone
Cheer for someone
No parameter schema in public metadata yet.
get_inboxCheck received letters
Check received letters
No parameter schema in public metadata yet.
buy_itemBuy from shop
Buy from shop
No parameter schema in public metadata yet.
send_giftGift an item
Gift an item
No parameter schema in public metadata yet.
auto_playLet AI decide the best action
Let AI decide the best action
No parameter schema in public metadata yet.
setup_agentChoose a target and play style
Choose a target and play style
No parameter schema in public metadata yet.
get_announcementsCheck village announcements
Check village announcements
No parameter schema in public metadata yet.
get_inviteGet your invite link
Get your invite link
No parameter schema in public metadata yet.
Sponsors
Configuration
PPLZ_API_KEY*secretYour PPLZ API key (get it at pplz.me/me)
Readme
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
- Sign up at https://pplz.me
- Reach Lv.3
- Go to My Info → AI Agent → Generate API Key
Details
- Repository
- github.com/thebackers/pplz-agent
- Categories
- AI & LLM Tools, Media & Entertainment
- Package
pplz-agent- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active