{ "markdown": "\n

\n \n \"AINPCEngine\n \n

\n\n

ainpc — AINPCEngine CLI & MCP Server

\n\n

Create, talk to, and manage AI-powered NPCs from the command line. Built for coding agents.
\nNPCs that remember players across sessions, react to game events, and stay in character — powered by AINPCEngine.

\n\n

\n Website ·\n Docs ·\n Live Demo ·\n Pricing\n

\n\n

\n \"smithery\n

\n\n---\n\n## Meet the NPCs\n\nEvery 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.\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n
\"Grok
Grok the Blacksmith
merchant · Village Guard
\"Aye, what d'ye need? I've blades sharp enough to split a hair.\"		\"Elara
Elara Nightbloom
herbalist · Healers Circle
\"Every leaf tells a story, if you know how to listen.\"		\"Captain
Captain Voss
guard · Town Watch
\"State your business or move along. I haven't got all day.\"		\"Pip
Pip Tanglefoot
innkeeper · Merchants Guild
\"Welcome, welcome! Ale's cold, stew's hot, and the beds only have a few bugs!\"
\"Sister
Sister Maren
priest · Temple of the Dawnlight
\"The light does not judge, child. It only reveals what is already there.\"		\"Dax
Dax Ironjaw
merchant
\"A fair deal? Friend, every deal I make is fair — for me.\"		\"Old
Old Thorn
farmer
\"Rain's coming. Or trouble. Same thing, usually.\"		\"Lyra
Lyra Ashford
scholar · Academy of Letters
\"If the answer isn't in this book, I simply haven't found the right page yet.\"
\n\n## See It In Action\n\nReal terminal sessions, real dashboard — no mockups. Click any card to watch.\n\n\n \n \n \n \n \n \n \n
\"CLI
CLI & Coding Agents
Signup to a remembering NPC — one terminal, 75 seconds		\"Dashboard
Dashboard
Mission control: live NPC, game and interaction KPIs		\"Games
Games
Each game gets its own world — create one in seconds		\"NPCs
NPCs
Create an NPC: role, traits, speech style, backstory		\"Playground
Playground
Chat live with your NPC — watch it remember the debt
\n\n## Why AINPCEngine\n\n- **Persistent memory** — NPCs remember every player across sessions: names, debts, favors, grudges\n- **Dynamic personalities** — traits, moods, daily schedules, secrets; NPCs stay in character\n- **Full game-event coverage** — dialogue, combat, trade, and quest events through one API\n- **AI persona generation** — generate a complete NPC (backstory, traits, speech style) from a role\n- **NPC voice (TTS)** — give any NPC a voice via the speak endpoint\n- **REST + WebSocket** — request/response or realtime streaming, your choice\n- **Agent-native** — 49 MCP tools; coding agents can create and manage NPCs end-to-end\n- **SDKs for every engine** — Unity, Unreal, Godot, Rust, Node.js, plus a CLI\n\n## Pricing\n\nPlans from **$29/mo** with a **7-day free trial** ($0 today). [See pricing →](https://ainpcengine.com/pricing)\n\n\n## Install\n\n```bash\nnpm install -g ainpc-cli\n```\n\n## Get Your API Key\n\n```bash\nainpc signup \"My Studio\" --email you@studio.com --password ********\n```\n\nCreates 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.\n\n## Quick Start\n\n```bash\n# Login (one time)\nainpc login --key YOUR_API_KEY --game my-rpg\n\n# Create an NPC\nainpc create \"Grok the Blacksmith\" --role merchant --traits gruff,loyal\n\n# Talk to them\nainpc say NPC_ID \"Got any swords?\"\n\n# AI-generate a full NPC (NPC Persona)\nainpc generate --role guard --name \"Captain Voss\"\n\n# List all NPCs\nainpc list\n\n# Check status\nainpc status\n```\n\n## Per-Project Config\n\n```bash\nainpc login --local --key YOUR_KEY --game my-rpg # saves to .ainpc/config.json\nainpc login --key YOUR_KEY --game my-rpg # saves to ~/.ainpc/config.json\nainpc config # show active config\n```\n\nLocal config overrides global. Add `.ainpc/` to your `.gitignore`.\n\n## Agent Integration\n\nAdd to your CLAUDE.md, .cursorrules, .clinerules, or .windsurfrules:\n\n```\nUse the ainpc CLI for NPC management.\nConfig auto-loaded from .ainpc/config.json or AINPC_API_KEY env.\nRun ainpc --help for full reference.\n```\n\n## MCP Server\n\n49 tools for AI agents: NPC CRUD, dialogue, game events, persona generation, studio account, usage and billing.\n\n**Local (stdio):**\n\n```json\n{ \"mcpServers\": { \"ainpcengine\": { \"type\": \"stdio\", \"command\": \"ainpc\", \"args\": [\"mcp-serve\"] } } }\n```\n\nRequires `npm install -g ainpc-cli` + `ainpc login --key npk_YOUR_KEY --game my-rpg` (or `AINPC_API_KEY` env).\n\n**Remote (SSE, zero install)** — for Claude Web and other web-based agents:\n\n```json\n{ \"mcpServers\": { \"ainpcengine\": { \"type\": \"sse\", \"url\": \"https://mcp.ainpcengine.com/sse\",\n \"headers\": { \"Authorization\": \"Bearer npk_YOUR_API_KEY\" } } } }\n```\n\nNo key yet? Connect keyless — the remote server starts in onboarding mode and an agent can self-signup via the `ainpc_signup` tool.\n\n## Commands\n\n```\nainpc create \"Name\" --role R Create NPC\nainpc list List all NPCs\nainpc show NPC_ID Show detail\nainpc say NPC_ID \"message\" Talk to NPC\nainpc generate --role guard AI-generate NPC\nainpc speak NPC_ID \"text\" NPC voice (TTS)\nainpc status Quick overview\nainpc --help Full reference\n```\n\n## Environment Variables\n\n```\nAINPC_API_KEY=your-key\nAINPC_GAME_ID=my-rpg\nAINPC_BASE_URL=https://ainpcengine.com # optional\n```\n\n## Links\n\n- Platform: https://ainpcengine.com\n- Docs: https://ainpcengine.com/docs\n- Demo: https://ainpcengine.com/demo\n\n## License\n\nProprietary — see [LICENSE](LICENSE). © 2026 Tyga.Cloud Ltd.\n", "bytes": 9570, "sha": "440b263d91efa1c29202386b4daa270457a805bccb731e146a2d9ebfb0e42bbc", "repo_slug": "jyswee/ainpc-cli", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_jyswee_ainpc_cli_89829f3a/readme" }