pplz-agent

Local

github.com/TheBackersGames & Entertainment0Updated 28w ago

About pplz-agent

pplz-agent is an MCP server for the PPLZ life simulation game, letting AI such as Claude and GPT participate automatically. Its tools cover character and resident information, in-game actions and social interactions, as well as goals and play styles.

Key features

01View character status and residents
02Take actions such as walking, resting, and fishing
03Send letters, encouragement, and gifts
04Check inbox and village announcements
05Set goals and play styles

Use cases

01Let AI participate in PPLZ automatically
02Review character status and plan in-game actions
03Communicate with residents or give gifts
04Automate play using a chosen style

MCP support

As an MCP server, it provides clients with PPLZ game tools for character status, actions, messages, gifts, and automated play.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "backers-shawn-pplz-agent": {
      "command": "npx",
      "args": [
        "-y",
        "pplz-agent"
      ],
      "env": {
        "PPLZ_API_KEY": "<PPLZ_API_KEY>"
      }
    }
  }
}

Run commandnpx -y pplz-agent

Environment variables to set

PPLZ_API_KEYSecretYour PPLZ API key (get it at pplz.me/me)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npmpplz-agent1.1.3stdio

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.