thebackers avatar

Pplz Agent

thebackers/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 tools

Public 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*secret

Your 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

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

View the full README on GitHub

Details

Repository
github.com/thebackers/pplz-agent
Categories
AI & LLM Tools, Media & Entertainment
Package
pplz-agent
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1trushtonfactory avatarAnthropic Admin Mcptrushtonfactory/anthropic-admin-mcpNative MCP server for the Anthropic Admin API: org, workspaces, members, API keys, usage, costs.0stars
2vk0dev avatarAgent Cost Mcpvk0dev/agent-cost-mcpCost Guard for Claude Code: per-tool ROI, subagent attribution, anomaly/forecast/budget guards.0stars
3wingedguardian avatarAgent Toolswingedguardian/agent-tools9 utility tools for agents: DNS, WHOIS, email, IP, URL, headers, QR, text, tech. x402 on Base.0stars
4twzrd-sol avatarTWZRD Agent Intelligencetwzrd-sol/twzrd-trustPre-spend trust for AI agents that buy: check x402 services and product listings before paying.0stars
5yourbright-jp avatarJPYC Agent MCPyourbright-jp/jpyc-agent-mcpOAuth-protected JPYC wallet, transfer, and contract workflows on Polygon.0stars
6neonia-io avatarNeonia: The Cloud Backend for AI Agentsneonia-io/agent-mcp-examplesMultiple MCP tools, persistent graph memory, token-saving data pointers, and more.0stars