How do I install Pplz Agent?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Pplz Agent need an API key?

The publisher lists these environment variables: PPLZ_API_KEY.

What transport does Pplz Agent use?

Pplz Agent runs locally over stdio.

When was Pplz Agent last checked?

Last checked 2026-11-08. PPLZ AI Agent — Let AI play your social life simulation automatically.

Pplz Agent MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

PPLZ_API_KEY — Your PPLZ API key (get it at pplz.me/me)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1PPLZ_API_KEY=<secret> claude mcp add io.github.backers-shawn-pplz-agent -- npx -y pplz-agent@1.1.3

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.backers-shawn-pplz-agent": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "PPLZ_API_KEY": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.1.3
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

Pplz Agent

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Pplz Agent?

Does Pplz Agent need an API key?

What transport does Pplz Agent use?

When was Pplz Agent last checked?

Documentation

pplz-agent 🤖

Quick Start

Claude (MCP)

Claude Desktop

GPT (Custom GPT)

Any AI

Get your API key

Available Tools

Play Styles

Links