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-10-16. PPLZ AI Agent — Let AI play your social life simulation automatically.

Pplz Agent

by io.github.Backers-Shawn

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

Power your agent

Add this server

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

Local command

npx -y [email protected]

Credentials from the publisher

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

Provider

Claude Code

PPLZ_API_KEY=<secret> claude mcp add io.github.backers-shawn-pplz-agent -- npx -y [email protected]

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.github.backers-shawn-pplz-agent": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "PPLZ_API_KEY": "<secret>"
      }
    }
  }
}

claude_desktop_config.json

Step-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

Related MCP

Related skills

View all

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

by io.github.Backers-Shawn

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

Power your agent

Add this server

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

Local command

npx -y [email protected]

Credentials from the publisher

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

Provider

Claude Code

PPLZ_API_KEY=<secret> claude mcp add io.github.backers-shawn-pplz-agent -- npx -y [email protected]

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.github.backers-shawn-pplz-agent": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "PPLZ_API_KEY": "<secret>"
      }
    }
  }
}

claude_desktop_config.json

Step-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

Related MCP

Related skills

View all

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.

Related MCP

Related skills

pplz-agent 🤖

Quick Start

Claude (MCP)

Claude Desktop

GPT (Custom GPT)

Any AI

Get your API key

Available Tools

Play Styles

Links

Pplz Agent

Add this server

Host a copy with our keys and logs.

Related MCP

Related skills

pplz-agent 🤖

Quick Start

Claude (MCP)

Claude Desktop

GPT (Custom GPT)

Any AI

Get your API key

Available Tools

Play Styles

Links