Ainpc Cli

Name: Ainpc Cli
Author: jyswee

by jysweeversion 1.5.4i★ –iComputer 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 checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

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: Search & AI memory
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: 1 of 1 passed
Runs on the maker’s server: what you ask it goes through their server.
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.

What it can do

We have not read this server’s tool list yet; we check endpoints in rotation.

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 6, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account jyswee, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
… Not checked yet
Endpoint responds
Not checked yet; we check endpoints in rotation
… Not checked yet
Sign-in with OAuth
Not checked yet; we check endpoints in rotation
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Compared with others in Search & AI memoryi

More stars than 0% of the other 7223 servers in this category
Published to the registry more recently than 47% of the other 7223 servers in this category
Basic checks equal to or better than 100% of the other 7223 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 1 of 1 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 –, and the latest version (1.5.4) reached the registry 44 days 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: Context7, Codebase Memory, Exa

Alternatives

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

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

Context7

by upstash

Feeds AI the latest docs for libraries and frameworks before it answers, so code it writes does not use outdated, removed functions.

Computer or cloud★ 64,224MITUpdated 3 days ago

Install

Codebase Memory

by DeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

Runs on your computer★ 48,148MITUpdated 20 days ago

Install

Exa

by exa-labs

Connect AI agents to Exa for web search, content fetching, and multi-step research.

Runs in the cloud★ 5,213MITUpdated 44 days ago

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

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 Search & AI memoryi

Common questions

Alternatives

Context7

Codebase Memory

Exa

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