Pplz Agent

io.github.Backers-ShawnPublished by GitHub account Backers-Shawnv1.1.3Updated Oct 24, 2026

PPLZ AI Agent — Let AI play your social life simulation automatically.

VerifiedSTDIODesktop only

Overview

AI-generated overview

Lets an assistant play the PPLZ social life simulation game automatically, checking status, acting, messaging, and gifting on your behalf.

What you can do
PPLZ Agent connects an assistant to the PPLZ life simulation game through a local npm package. Tools include get_status, do_action for activities like walking, resting, fishing, cooking or reading, send_message, get_people, encourage, get_inbox, buy_item, send_gift, auto_play, setup_agent, get_announcements and get_invite. A setup_agent tool selects a target and play style such as romantic, active, ambitious, gentle or chaotic.
When to use it
Use it if you already play PPLZ and want an assistant to keep the character active, run daily actions, send letters and gifts, or follow a chosen play style without manual input.
Requirements
Runs locally via npx (Node.js) as a stdio MCP server. Requires a PPLZ account and an API key supplied as PPLZ_API_KEY, obtained after signing up and reaching level 3. Network access to the PPLZ service is needed.
Before you install
The API key PPLZ_API_KEY is a credential and should be kept private. Tools act on your game account: do_action, send_message, buy_item, send_gift and auto_play change game state and may spend in-game currency or items, and auto_play lets the assistant decide actions on its own.

Installation

In SourceWeft

  1. Open Pplz Agent in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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/publicAuth: 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

ToolDescription
get_statusCheck your character status
do_actionPerform actions (walk, rest, fish, cook, read, etc.)
send_messageSend a letter (1 per day, 30 chars)
get_peopleSee village residents
encourageCheer for someone
get_inboxCheck received letters
buy_itemBuy from shop
send_giftGift an item
auto_playLet AI decide the best action
setup_agentChoose a target and play style
get_announcementsCheck village announcements
get_inviteGet your invite link

Play Styles

StyleDescription
🌹 romanticFocus on letters, gifts, cheering
⚡ activeAll-around active play
👑 ambitiousMoney, exploration, career
🍃 gentleWalking, reading, relaxing
🎲 chaoticCompletely random

Links

Source: README.md at commit 916d3b7

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.1.3LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.