<p align="center">
  <a href="https://ainpcengine.com">
    <img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/ainpcengine-hero-1.jpg" alt="AINPCEngine — AI-powered NPCs with persistent memory" width="100%">
  </a>
</p>

<h1 align="center">ainpc — AINPCEngine CLI & MCP Server</h1>

<p align="center"><b>Create, talk to, and manage AI-powered NPCs from the command line. Built for coding agents.</b><br>
NPCs that remember players across sessions, react to game events, and stay in character — powered by <a href="https://ainpcengine.com">AINPCEngine</a>.</p>

<p align="center">
  <a href="https://ainpcengine.com">Website</a> ·
  <a href="https://ainpcengine.com/docs">Docs</a> ·
  <a href="https://ainpcengine.com/demo">Live Demo</a> ·
  <a href="https://ainpcengine.com/pricing">Pricing</a>
</p>

<p align="center">
  <a href="https://smithery.ai/servers/jyswee/ainpcengine"><img src="https://smithery.ai/badge/jyswee/ainpcengine" alt="smithery badge"></a>
</p>

---

## Meet the NPCs

Every one of these is a live AI NPC on the [public demo](https://ainpcengine.com/demo) — persistent memory, daily schedules, moods, and secrets. Click through and talk to them.

<table>
  <tr>
    <td align="center" width="25%"><a href="https://ainpcengine.com/demo"><img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/npc_grok_the_blacksmith.webp" alt="Grok the Blacksmith" width="100%"></a><br><b>Grok the Blacksmith</b><br><i>merchant · Village Guard</i><br><sub>"Aye, what d'ye need? I've blades sharp enough to split a hair."</sub></td>
    <td align="center" width="25%"><a href="https://ainpcengine.com/demo"><img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/npc_elara_nightbloom.webp" alt="Elara Nightbloom" width="100%"></a><br><b>Elara Nightbloom</b><br><i>herbalist · Healers Circle</i><br><sub>"Every leaf tells a story, if you know how to listen."</sub></td>
    <td align="center" width="25%"><a href="https://ainpcengine.com/demo"><img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/npc_captain_voss.webp" alt="Captain Voss" width="100%"></a><br><b>Captain Voss</b><br><i>guard · Town Watch</i><br><sub>"State your business or move along. I haven't got all day."</sub></td>
    <td align="center" width="25%"><a href="https://ainpcengine.com/demo"><img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/npc_pip_tanglefoot.webp" alt="Pip Tanglefoot" width="100%"></a><br><b>Pip Tanglefoot</b><br><i>innkeeper · Merchants Guild</i><br><sub>"Welcome, welcome! Ale's cold, stew's hot, and the beds only have a few bugs!"</sub></td>
  </tr>
  <tr>
    <td align="center" width="25%"><a href="https://ainpcengine.com/demo"><img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/npc_sister_maren.webp" alt="Sister Maren" width="100%"></a><br><b>Sister Maren</b><br><i>priest · Temple of the Dawnlight</i><br><sub>"The light does not judge, child. It only reveals what is already there."</sub></td>
    <td align="center" width="25%"><a href="https://ainpcengine.com/demo"><img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/npc_dax_ironjaw.webp" alt="Dax Ironjaw" width="100%"></a><br><b>Dax Ironjaw</b><br><i>merchant</i><br><sub>"A fair deal? Friend, every deal I make is fair — for me."</sub></td>
    <td align="center" width="25%"><a href="https://ainpcengine.com/demo"><img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/npc_old_thorn.webp" alt="Old Thorn" width="100%"></a><br><b>Old Thorn</b><br><i>farmer</i><br><sub>"Rain's coming. Or trouble. Same thing, usually."</sub></td>
    <td align="center" width="25%"><a href="https://ainpcengine.com/demo"><img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/npc_lyra_ashford.webp" alt="Lyra Ashford" width="100%"></a><br><b>Lyra Ashford</b><br><i>scholar · Academy of Letters</i><br><sub>"If the answer isn't in this book, I simply haven't found the right page yet."</sub></td>
  </tr>
</table>

## See It In Action

Real terminal sessions, real dashboard — no mockups. Click any card to watch.

<table>
  <tr>
    <td align="center" width="20%"><a href="https://ainpcengine.com/#demo-videos"><img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/ainpc-gtm-1-poster.png" alt="CLI & Coding Agents demo" width="100%"></a><br><b>CLI & Coding Agents</b><br><sub>Signup to a remembering NPC — one terminal, 75 seconds</sub></td>
    <td align="center" width="20%"><a href="https://ainpcengine.com/#demo-videos"><img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/ainpc-gtm-2-poster.png" alt="Dashboard demo" width="100%"></a><br><b>Dashboard</b><br><sub>Mission control: live NPC, game and interaction KPIs</sub></td>
    <td align="center" width="20%"><a href="https://ainpcengine.com/#demo-videos"><img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/ainpc-gtm-3-poster.png" alt="Games demo" width="100%"></a><br><b>Games</b><br><sub>Each game gets its own world — create one in seconds</sub></td>
    <td align="center" width="20%"><a href="https://ainpcengine.com/#demo-videos"><img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/ainpc-gtm-4-poster.png" alt="NPCs demo" width="100%"></a><br><b>NPCs</b><br><sub>Create an NPC: role, traits, speech style, backstory</sub></td>
    <td align="center" width="20%"><a href="https://ainpcengine.com/#demo-videos"><img src="https://prodmedia.tyga.host/public/tyga.cloud/landing/ainpcengine.com/ainpc-gtm-5-poster.png" alt="Playground demo" width="100%"></a><br><b>Playground</b><br><sub>Chat live with your NPC — watch it remember the debt</sub></td>
  </tr>
</table>

## Why AINPCEngine

- **Persistent memory** — NPCs remember every player across sessions: names, debts, favors, grudges
- **Dynamic personalities** — traits, moods, daily schedules, secrets; NPCs stay in character
- **Full game-event coverage** — dialogue, combat, trade, and quest events through one API
- **AI persona generation** — generate a complete NPC (backstory, traits, speech style) from a role
- **NPC voice (TTS)** — give any NPC a voice via the speak endpoint
- **REST + WebSocket** — request/response or realtime streaming, your choice
- **Agent-native** — 49 MCP tools; coding agents can create and manage NPCs end-to-end
- **SDKs for every engine** — Unity, Unreal, Godot, Rust, Node.js, plus a CLI

## Pricing

Plans from **$29/mo** with a **7-day free trial** ($0 today). [See pricing →](https://ainpcengine.com/pricing)


## Install

```bash
npm install -g ainpc-cli
```

## Get Your API Key

```bash
ainpc signup "My Studio" --email you@studio.com --password ********
```

Creates your studio and auto-saves an `npk_` API key. Then log in at https://ainpcengine.com and add a card to start the **7-day free trial** ($0 today, plans from $29/mo). Or sign up at https://ainpcengine.com/auth/register and generate a key in Studio Dashboard → API Keys.

## Quick Start

```bash
# Login (one time)
ainpc login --key YOUR_API_KEY --game my-rpg

# Create an NPC
ainpc create "Grok the Blacksmith" --role merchant --traits gruff,loyal

# Talk to them
ainpc say NPC_ID "Got any swords?"

# AI-generate a full NPC (NPC Persona)
ainpc generate --role guard --name "Captain Voss"

# List all NPCs
ainpc list

# Check status
ainpc status
```

## Per-Project Config

```bash
ainpc login --local --key YOUR_KEY --game my-rpg   # saves to .ainpc/config.json
ainpc login --key YOUR_KEY --game my-rpg           # saves to ~/.ainpc/config.json
ainpc config                                       # show active config
```

Local config overrides global. Add `.ainpc/` to your `.gitignore`.

## Agent Integration

Add to your CLAUDE.md, .cursorrules, .clinerules, or .windsurfrules:

```
Use the ainpc CLI for NPC management.
Config auto-loaded from .ainpc/config.json or AINPC_API_KEY env.
Run ainpc --help for full reference.
```

## MCP Server

49 tools for AI agents: NPC CRUD, dialogue, game events, persona generation, studio account, usage and billing.

**Local (stdio):**

```json
{ "mcpServers": { "ainpcengine": { "type": "stdio", "command": "ainpc", "args": ["mcp-serve"] } } }
```

Requires `npm install -g ainpc-cli` + `ainpc login --key npk_YOUR_KEY --game my-rpg` (or `AINPC_API_KEY` env).

**Remote (SSE, zero install)** — for Claude Web and other web-based agents:

```json
{ "mcpServers": { "ainpcengine": { "type": "sse", "url": "https://mcp.ainpcengine.com/sse",
  "headers": { "Authorization": "Bearer npk_YOUR_API_KEY" } } } }
```

No key yet? Connect keyless — the remote server starts in onboarding mode and an agent can self-signup via the `ainpc_signup` tool.

## Commands

```
ainpc create "Name" --role R          Create NPC
ainpc list                            List all NPCs
ainpc show NPC_ID                     Show detail
ainpc say NPC_ID "message"            Talk to NPC
ainpc generate --role guard           AI-generate NPC
ainpc speak NPC_ID "text"             NPC voice (TTS)
ainpc status                          Quick overview
ainpc --help                          Full reference
```

## Environment Variables

```
AINPC_API_KEY=your-key
AINPC_GAME_ID=my-rpg
AINPC_BASE_URL=https://ainpcengine.com   # optional
```

## Links

- Platform: https://ainpcengine.com
- Docs: https://ainpcengine.com/docs
- Demo: https://ainpcengine.com/demo

## License

Proprietary — see [LICENSE](LICENSE). © 2026 Tyga.Cloud Ltd.