Ainpc Cli

Name: Ainpc Cli
Author: jyswee

by jysweeversion 1.5.4i★ 1iComputer or cloud

Registry nameio.github.jyswee/ainpc-cli

Install

Overview

Description from the maker (original English)

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

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi4 of 4 passedChecked from public information; code not scanned yet
UsageiVery new↓ 52/wk · ★ 1

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Computer or cloud
Transport: stdio, Streamable HTTP, SSE
Category: Developer tools
You need to fill in: AINPC_API_KEY, Authorization

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 4 of 4 passed
Runs on the maker’s server: what you ask it goes through their server.
Can do 2 things (tools) ainpc_get_started, ainpc_signup
You fill in yourself: AINPC_API_KEY, AINPC_GAME_ID, Authorization

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Runs in the cloudNothing to install; it connects over the internet
npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Or run it on your computer

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "ainpc-cli": {
      "command": "npx",
      "args": [
        "-y",
        "ainpc-cli"
      ],
      "env": {
        "AINPC_API_KEY": "your-value",
        "AINPC_GAME_ID": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add --transport http ainpc-cli https://mcp.ainpcengine.com/mcp --header 'Authorization: your-value'

Or run it on your computer

claude mcp add ainpc-cli --env AINPC_API_KEY=your-value --env AINPC_GAME_ID=your-value -- npx -y ainpc-cli

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "ainpc-cli": {
      "url": "https://mcp.ainpcengine.com/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

Or run it on your computer

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "ainpc-cli": {
      "command": "npx",
      "args": [
        "-y",
        "ainpc-cli"
      ],
      "env": {
        "AINPC_API_KEY": "your-value",
        "AINPC_GAME_ID": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "ainpc-cli": {
      "type": "http",
      "url": "https://mcp.ainpcengine.com/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

Or run it on your computer

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "ainpc-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ainpc-cli"
      ],
      "env": {
        "AINPC_API_KEY": "your-value",
        "AINPC_GAME_ID": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

AINPC_API_KEY secret required env
AINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial.
AINPC_GAME_ID env
Game slug to scope NPC tools to.
Authorization secret HTTP header
Bearer token using your AINPCEngine API key: 'Bearer npk_...'. Optional: without one the server starts in onboarding mode and can self-signup via the ainpc_signup tool.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

Claude ChatGPT Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Open WebUI Raycast

Run on your computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

All apps, with pros and cons →

What it can do

Tool names and descriptions exactly as the server reported them on Nov 9, 2026. The maker wrote them, not us; we show them as plain text.

ainpc_get_started
Explains what AINPCEngine is and how to activate this MCP server (no API key on this session yet).
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 immedia

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 11, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account jyswee, which owns the repo
✓ Pass
Still maintained
Code last changed 2 months ago
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
✓ Pass
Endpoint responds
Responded in 344 ms (HTTP 200)
– Not applicable
Sign-in with OAuth
No sign-in needed
✓ Pass
No hidden instructions in tool descriptions
Read 2 tool descriptions and found no hidden instructions to the AI

Compared with others in Developer toolsi

More stars than 65% of the other 5736 servers in this category
Published to the registry more recently than 42% of the other 5736 servers in this category
Basic checks equal to or better than 100% of the other 5736 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Ainpc Cli safe?

It passed 4 of 4 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: AINPC_API_KEY, Authorization

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 2 months ago, and the latest version (1.5.4) reached the registry 2 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: REA, Netdata, Front-End Checklist

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

by morlutoWidely used↓ 388.7K/wk★ 448.2KUpdated 16 days ago

Runs on your computer

Install

Netdata

Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.

by netdataWidely used★ 81.3KUpdated 6 days ago

Runs in the cloud

Install

Front-End Checklist

Review frontend code and live pages against 386 quality-gated web development rules.

by thedaviddiasWidely used★ 74.7KUpdated 37 days ago

Runs in the cloud

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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

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 merchant · Village Guard "Aye, what d'ye need? I've blades sharp enough to split a hair."

Elara Nightbloom herbalist · Healers Circle "Every leaf tells a story, if you know how to listen."

Captain Voss guard · Town Watch "State your business or move along. I haven't got all day."

Pip Tanglefoot innkeeper · Merchants Guild "Welcome, welcome! Ale's cold, stew's hot, and the beds only have a few bugs!"

Sister Maren priest · Temple of the Dawnlight "The light does not judge, child. It only reveals what is already there."

Dax Ironjaw merchant "A fair deal? Friend, every deal I make is fair — for me."

Old Thorn farmer "Rain's coming. Or trouble. Same thing, usually."

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 Signup to a remembering NPC — one terminal, 75 seconds

Dashboard Mission control: live NPC, game and interaction KPIs

Games Each game gets its own world — create one in seconds

NPCs Create an NPC: role, traits, speech style, backstory

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

npm install -g ainpc-cli

Get Your API Key

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

# 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

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):

{ "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:

{ "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

Ainpc Cli

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Or run it on your computer

Or run it on your computer

Or run it on your computer

Or run it on your computer

Values you fill in

Which apps can use it

Related guides

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Developer toolsi

Common questions

Alternatives

REA

Netdata

Front-End Checklist

README from the maker

Meet the NPCs

See It In Action

Why AINPCEngine

Pricing

Install

Get Your API Key

Quick Start

Create an NPC

Talk to them

AI-generate a full NPC (NPC Persona)

List all NPCs

Check status

Per-Project Config

Agent Integration

MCP Server

Commands

Environment Variables

Links

License