Ainpc Cli

io.github.jysweePublished by GitHub account jysweev1.5.4Updated Nov 2, 2026

AI NPCs with persistent memory for game studios. NPC CRUD, dialogue, voice. Stdio or remote SSE.

The publisher's own server: Vips

VerifiedStreamable HTTPWeb executableDeveloper ToolsMedia & DesignAI & ML

Overview

AI-generated overview

Ainpc Cli connects an assistant to AINPCEngine so it can create, talk to and manage AI game NPCs with persistent memory, voice and persona generation.

What you can do
  • Create, list, show and manage NPCs within a game, including AI-generated personas from a role, name and traits
  • Talk to NPCs and drive dialogue, combat, trade and quest game events through one API
  • Give NPCs a voice with text-to-speech output
  • Handle studio account setup, usage and billing through the same tool set
  • Sign up for an AINPCEngine studio account and obtain an API key from inside the session
When to use it
Useful for game studios and coding agents that want to author, populate and test AI NPCs with persistent player memory from a terminal or an assistant session, rather than through a dashboard.
Requirements
Either the remote endpoint with an Authorization bearer header, or the local npm package run via npx or a global install. Needs an AINPCEngine API key in AINPC_API_KEY or the Authorization header, and optionally AINPC_GAME_ID to scope NPC tools to a game. Without a key the server starts in onboarding mode.
Before you install
Signup asks for a human email and password and returns an API key shown only once; the account then requires adding a card at the vendor site to start a 7-day trial, with plans from $29/mo, so real charges follow. Tools can create and change NPCs and game data, and the service is a paid third-party platform that receives your game content. Keep the API key out of committed config files.

Installation

In SourceWeft

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

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.jyswee%2Fainpc-cli/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "ainpc-cli": {
      "type": "http",
      "url": "https://mcp.ainpcengine.com/mcp"
    }
  }
}

README

[AINPCEngine — AI-powered NPCs with persistent memory]

ainpc — AINPCEngine CLI & MCP Server

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

Website · Docs · Live Demo · Pricing

[smithery badge]

Meet the NPCs

Every one of these is a live AI NPC on the public demo — persistent memory, daily schedules, moods, and secrets. Click through and talk to them.

[Grok the Blacksmith]
Grok the Blacksmith
merchant · Village Guard
"Aye, what d'ye need? I've blades sharp enough to split a hair."		[Elara Nightbloom]
Elara Nightbloom
herbalist · Healers Circle
"Every leaf tells a story, if you know how to listen."		[Captain Voss]
Captain Voss
guard · Town Watch
"State your business or move along. I haven't got all day."		[Pip Tanglefoot]
Pip Tanglefoot
innkeeper · Merchants Guild
"Welcome, welcome! Ale's cold, stew's hot, and the beds only have a few bugs!"
[Sister Maren]
Sister Maren
priest · Temple of the Dawnlight
"The light does not judge, child. It only reveals what is already there."		[Dax Ironjaw]
Dax Ironjaw
merchant
"A fair deal? Friend, every deal I make is fair — for me."		[Old Thorn]
Old Thorn
farmer
"Rain's coming. Or trouble. Same thing, usually."		[Lyra Ashford]
Lyra Ashford
scholar · Academy of Letters
"If the answer isn't in this book, I simply haven't found the right page yet."

See It In Action

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

[CLI & Coding Agents demo]
CLI & Coding Agents
Signup to a remembering NPC — one terminal, 75 seconds		[Dashboard demo]
Dashboard
Mission control: live NPC, game and interaction KPIs		[Games demo]
Games
Each game gets its own world — create one in seconds		[NPCs demo]
NPCs
Create an NPC: role, traits, speech style, backstory		[Playground demo]
Playground
Chat live with your NPC — watch it remember the debt

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 →

Install

bash
npm install -g ainpc-cli

Get Your API Key

bash
ainpc signup "My Studio" --email [email protected] --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 NPCainpc create "Grok the Blacksmith" --role merchant --traits gruff,loyal
# Talk to themainpc say NPC_ID "Got any swords?"
# AI-generate a full NPC (NPC Persona)ainpc generate --role guard --name "Captain Voss"
# List all NPCsainpc list
# Check statusainpc status

Per-Project Config

bash
ainpc login --local --key YOUR_KEY --game my-rpg   # saves to .ainpc/config.jsonainpc login --key YOUR_KEY --game my-rpg           # saves to ~/.ainpc/config.jsonainpc 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 NPCainpc list                            List all NPCsainpc show NPC_ID                     Show detailainpc say NPC_ID "message"            Talk to NPCainpc generate --role guard           AI-generate NPCainpc speak NPC_ID "text"             NPC voice (TTS)ainpc status                          Quick overviewainpc --help                          Full reference

Environment Variables

AINPC_API_KEY=your-keyAINPC_GAME_ID=my-rpgAINPC_BASE_URL=https://ainpcengine.com   # optional

Links

License

Proprietary — see LICENSE. © 2026 Tyga.Cloud Ltd.

Source: README.md at commit 5d1cc16

Tools

2

ainpc_get_started

Explains what AINPCEngine is and how to activate this MCP server (no API key on this session yet).

Takes no parameters.

ainpc_signup

Create a new AINPCEngine studio account. Requires the human's email and a password (min 8 chars): they log in at ainpcengine.com and add a card to start the 7-day free trial ($0 today). Returns an npk_ API key (shown once) and unlocks all AINPCEngine tools in this session immediately. Ask the human for their email before calling.

Parametersnamerequiredplanemailrequiredpasswordrequired

Version history

2
  1. v1.5.4LatestSep 23, 2026
  2. v1.5.3Sep 16, 2026

Score

90% 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 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Vipsallowed integrations

Vips

com.vipsallowedOfficial publisher

VIPsAllowed's MCP server lets an assistant run a creator business: post content, manage subscribers, send paid DMs, track earnings and payouts.

SSEWeb executable
Finance2 toolsOct 24, 2026

Computegpu

Published by GitHub account jyswee

Lets an assistant rent cloud GPUs: browse the live catalogue, deploy, stop, resume and destroy instances, with per-second billing.

Streamable HTTPWeb executable
Cloud & Infrastructure2 toolsOct 28, 2026

Weselltours

Published by GitHub account jyswee

A local MCP server for the WeSellTours travel platform that lets an assistant manage hotels, tours and bookings, track bugs and features, and query travel AI.

STDIODesktop only
Location & LifestyleNot validated yetOct 25, 2026

Taufunctions

Published by GitHub account jyswee

TauFunctions lets an assistant create, deploy, invoke and monitor serverless functions on the TauFunctions platform, locally via npm or as a remote endpoint.

Streamable HTTPWeb executable
Cloud & Infrastructure2 toolsOct 24, 2026

Sslwebsites

Published by GitHub account jyswee

A local MCP server that lets a coding agent issue, renew, revoke, download and monitor SSL/TLS certificates through the SSLWebsites service.

STDIODesktop only
Cloud & InfrastructureNot validated yetOct 24, 2026