AINPCEngine MCP server

Q: How do I add AINPCEngine MCP to Claude Code?

Run `claude mcp add --env 'AINPC_API_KEY= ' ainpc-cli -- npx -y ainpc-cli` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add AINPCEngine MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

✓ VerifiedCommit Sep 24, 2026

jyswee/ainpc-cli

Lets AI agents create, manage, and interact with NPCs that feature persistent memory, dynamic personalities, and voice capabilities.

Also known as jyswee/ainpc-cli

stdio remote Workflow Automation

Install GitHub ↗

Stars: 1
Tools: —
Downloads, 30 days: —
Latest version: 1.5.4
Last commit: Sep 24, 2026
License: —

What is AINPCEngine MCP?

AINPCEngine lets AI agents create, manage, and interact with NPCs that feature persistent memory, dynamic personalities, and voice capabilities.

Summary generated from the project's README

About AINPCEngine MCP server

Creating and managing intelligent game characters from within an AI agent is what ainpc-cli enables. This MCP server provides coding agents with 49 specialized tools to handle NPC lifecycle tasks, including creation, dialogue, and persona generation. It is designed for developers building games or simulations who need characters with persistent memory, dynamic moods, and daily schedules that react to player actions.

Users can set up the server locally using the stdio transport by installing the CLI via npm and logging in with an API key. For web-based agents, a remote SSE connection is available that requires an Authorization header with your API key. The system supports both request-response and real-time streaming through REST and WebSocket protocols. Beyond simple text, the server includes a speak endpoint to provide voice capabilities to characters via text-to-speech.

What you can do with it

1Generate complete NPC personasAsk an AI agent to build a fully fleshed-out character including backstory and speech style based on a simple role.
2Manage character memory and dialogueHave an agent interact with NPCs to test how they remember player debts, favors, or grudges across different sessions.

Written from the project's README. Every use case is checked against a quote from it.

How to install AINPCEngine MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cli

~/.cursor/mcp.json

{
  "mcpServers": {
    "ainpc-cli": {
      "command": "npx",
      "args": [
        "-y",
        "ainpc-cli"
      ],
      "env": {
        "AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "ainpc-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ainpc-cli"
      ],
      "env": {
        "AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
      }
    }
  }
}

$ code --add-mcp '{"name":"ainpc-cli","type":"stdio","command":"npx","args":["-y","ainpc-cli"],"env":{"AINPC_API_KEY":"<YOUR_AINPC_API_KEY>"}}'

claude_desktop_config.json

{
  "mcpServers": {
    "ainpc-cli": {
      "command": "npx",
      "args": [
        "-y",
        "ainpc-cli"
      ],
      "env": {
        "AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
      }
    }
  }
}

$ codex mcp add ainpc-cli --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' -- npx -y ainpc-cli

~/.codex/config.toml

[mcp_servers.ainpc-cli]
command = "npx"
args = ["-y", "ainpc-cli"]

[mcp_servers.ainpc-cli.env]
AINPC_API_KEY = "<YOUR_AINPC_API_KEY>"

$ gemini mcp add -s user -e 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli npx -- -y ainpc-cli

~/.gemini/settings.json

{
  "mcpServers": {
    "ainpc-cli": {
      "command": "npx",
      "args": [
        "-y",
        "ainpc-cli"
      ],
      "env": {
        "AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
      }
    }
  }
}

Set 3 environment variables before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

AINPC_API_KEYRequiredSecret
AINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial.
AINPC_BASE_URL
AINPC_GAME_ID
Game slug to scope NPC tools to.

Name	Description
AINPC_API_KEY	AINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial.	RequiredSecret
AINPC_BASE_URL	—
AINPC_GAME_ID	Game slug to scope NPC tools to.

Automated checks

Ran Nov 14, 2026Full report →

93/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points

Show this score in your README

Source repository linked and reachablejyswee/ainpc-cli is public and reachablegithub.com/jyswee/ainpc-cli ↗Pass
Package names this repository as its sourceainpc-cli names jyswee/ainpc-cli as sourcenpmjs.com/package/ainpc-cli ↗Pass
Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
Open source license (OSI)No licenseFinding
Commit or release in the last yearLast commit or release 2026-09-24github.com/jyswee/ainpc-cli ↗Pass
OpenSSF ScorecardNot checked
Package name not close to a popular packageNo popular package one edit away from ainpc-cliPass
No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
Destructive tools are labelledNot checked
Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 115 msPass

README

View on GitHub

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.

See It In Action

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

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

License

Read full README

AINPCEngine MCP questions

How do I add AINPCEngine MCP to Claude Code?

Run claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cli in your terminal. Add --scope user to make it available in every project.

How do I add AINPCEngine MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What can the AI agent do with this server?

The server provides 49 tools for AI agents to perform NPC CRUD operations, dialogue, game events, persona generation, and manage studio accounts.

Do the NPCs have memory?

Yes, the NPCs feature persistent memory, allowing them to remember players, names, debts, favors, and grudges across different sessions.

How do I install the CLI?

You can install the CLI globally using the npm command: npm install -g ainpc-cli.

Can I use this with web-based agents like Claude Web?

Yes, you can use the remote SSE connection for Claude Web and other web-based agents without needing a local installation.

Facts

Nov 14, 2026

Stars: 1
Downloads, 30 days: —
Latest version: 1.5.4
Last commit: Sep 24, 2026
License: —
Transport: stdio, remote
Package: ainpc-cli

jyswee ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/jyswee/ainpc-cli.svg)](https://hostedmcp.org/servers/jyswee/ainpc-cli/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

AINPCEngine MCP server

✓ VerifiedCommit Sep 24, 2026

jyswee/ainpc-cli

Lets AI agents create, manage, and interact with NPCs that feature persistent memory, dynamic personalities, and voice capabilities.

Also known as jyswee/ainpc-cli

stdio remote Workflow Automation

Install GitHub ↗

Stars: 1
Tools: —
Downloads, 30 days: —
Latest version: 1.5.4
Last commit: Sep 24, 2026
License: —

What is AINPCEngine MCP?

AINPCEngine lets AI agents create, manage, and interact with NPCs that feature persistent memory, dynamic personalities, and voice capabilities.

Summary generated from the project's README

About AINPCEngine MCP server

What you can do with it

1Generate complete NPC personasAsk an AI agent to build a fully fleshed-out character including backstory and speech style based on a simple role.
2Manage character memory and dialogueHave an agent interact with NPCs to test how they remember player debts, favors, or grudges across different sessions.

Written from the project's README. Every use case is checked against a quote from it.

How to install AINPCEngine MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cli

~/.cursor/mcp.json

{
  "mcpServers": {
    "ainpc-cli": {
      "command": "npx",
      "args": [
        "-y",
        "ainpc-cli"
      ],
      "env": {
        "AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "ainpc-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ainpc-cli"
      ],
      "env": {
        "AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
      }
    }
  }
}

$ code --add-mcp '{"name":"ainpc-cli","type":"stdio","command":"npx","args":["-y","ainpc-cli"],"env":{"AINPC_API_KEY":"<YOUR_AINPC_API_KEY>"}}'

claude_desktop_config.json

{
  "mcpServers": {
    "ainpc-cli": {
      "command": "npx",
      "args": [
        "-y",
        "ainpc-cli"
      ],
      "env": {
        "AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
      }
    }
  }
}

$ codex mcp add ainpc-cli --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' -- npx -y ainpc-cli

~/.codex/config.toml

[mcp_servers.ainpc-cli]
command = "npx"
args = ["-y", "ainpc-cli"]

[mcp_servers.ainpc-cli.env]
AINPC_API_KEY = "<YOUR_AINPC_API_KEY>"

$ gemini mcp add -s user -e 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli npx -- -y ainpc-cli

~/.gemini/settings.json

{
  "mcpServers": {
    "ainpc-cli": {
      "command": "npx",
      "args": [
        "-y",
        "ainpc-cli"
      ],
      "env": {
        "AINPC_API_KEY": "<YOUR_AINPC_API_KEY>"
      }
    }
  }
}

Set 3 environment variables before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

AINPC_API_KEYRequiredSecret
AINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial.
AINPC_BASE_URL
AINPC_GAME_ID
Game slug to scope NPC tools to.

Name	Description
AINPC_API_KEY	AINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial.	RequiredSecret
AINPC_BASE_URL	—
AINPC_GAME_ID	Game slug to scope NPC tools to.

Automated checks

Ran Nov 14, 2026Full report →

93/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points

Show this score in your README

Source repository linked and reachablejyswee/ainpc-cli is public and reachablegithub.com/jyswee/ainpc-cli ↗Pass
Package names this repository as its sourceainpc-cli names jyswee/ainpc-cli as sourcenpmjs.com/package/ainpc-cli ↗Pass
Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
Open source license (OSI)No licenseFinding
Commit or release in the last yearLast commit or release 2026-09-24github.com/jyswee/ainpc-cli ↗Pass
OpenSSF ScorecardNot checked
Package name not close to a popular packageNo popular package one edit away from ainpc-cliPass
No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
Destructive tools are labelledNot checked
Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 115 msPass

README

View on GitHub

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.

See It In Action

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

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 ********

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

License

Read full README

AINPCEngine MCP questions

How do I add AINPCEngine MCP to Claude Code?

Run claude mcp add --env 'AINPC_API_KEY=<YOUR_AINPC_API_KEY>' ainpc-cli -- npx -y ainpc-cli in your terminal. Add --scope user to make it available in every project.

How do I add AINPCEngine MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What can the AI agent do with this server?

The server provides 49 tools for AI agents to perform NPC CRUD operations, dialogue, game events, persona generation, and manage studio accounts.

Do the NPCs have memory?

Yes, the NPCs feature persistent memory, allowing them to remember players, names, debts, favors, and grudges across different sessions.

How do I install the CLI?

You can install the CLI globally using the npm command: npm install -g ainpc-cli.

Can I use this with web-based agents like Claude Web?

Yes, you can use the remote SSE connection for Claude Web and other web-based agents without needing a local installation.

Facts

Nov 14, 2026

Stars: 1
Downloads, 30 days: —
Latest version: 1.5.4
Last commit: Sep 24, 2026
License: —
Transport: stdio, remote
Package: ainpc-cli

jyswee ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/jyswee/ainpc-cli.svg)](https://hostedmcp.org/servers/jyswee/ainpc-cli/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

AINPCEngine MCP server

What is AINPCEngine MCP?

About AINPCEngine MCP server

What you can do with it

How to install AINPCEngine MCP

Install AINPCEngine MCP in Claude Code

Install AINPCEngine MCP in Cursor

Install AINPCEngine MCP in VS Code

Install AINPCEngine MCP in VS Code CLI

Install AINPCEngine MCP in Claude Desktop

Install AINPCEngine MCP in Codex

Install AINPCEngine MCP in Codex config.toml

Install AINPCEngine MCP in Gemini CLI

Install AINPCEngine MCP in Gemini settings.json

Configuration

Automated checks

README

Meet the NPCs

See It In Action

Why AINPCEngine

Pricing

Install

Get Your API Key

Quick Start

Per-Project Config

Agent Integration

MCP Server

Commands

Environment Variables

Links

License

AINPCEngine MCP questions

AINPCEngine MCP server

What is AINPCEngine MCP?

About AINPCEngine MCP server

What you can do with it

How to install AINPCEngine MCP

Install AINPCEngine MCP in Claude Code

Install AINPCEngine MCP in Cursor

Install AINPCEngine MCP in VS Code

Install AINPCEngine MCP in VS Code CLI

Install AINPCEngine MCP in Claude Desktop

Install AINPCEngine MCP in Codex

Install AINPCEngine MCP in Codex config.toml

Install AINPCEngine MCP in Gemini CLI

Install AINPCEngine MCP in Gemini settings.json

Configuration

Automated checks

README

Meet the NPCs

See It In Action

Why AINPCEngine

Pricing

Install

Get Your API Key

Quick Start

Per-Project Config

Agent Integration

MCP Server

Commands

Environment Variables

Links

License

AINPCEngine MCP questions