protogrid

Search / io.github.jyswee/ainpc-cli

ainpc-cli

R1· needs a key

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

v1.5.4 · active · repository · website · descriptor JSON · versions

An agent can connect on its own if it already holds AINPC_CLI_TOKEN.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality85good
Trust67of 100
Uptime, 30 days24%
Latency p50753 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "ainpc-cli": {
      "type": "http",
      "url": "https://mcp.ainpcengine.com/mcp",
      "headers": {
        "Authorization": "Bearer ${AINPC_CLI_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http ainpc-cli https://mcp.ainpcengine.com/mcp --header "Authorization: Bearer ${AINPC_CLI_TOKEN}"
[mcp_servers.ainpc-cli]
url = "https://mcp.ainpcengine.com/mcp"
bearer_token_env_var = "AINPC_CLI_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ainpc-cli": {
      "type": "remote",
      "url": "https://mcp.ainpcengine.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:AINPC_CLI_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "ainpc-cli": {
      "type": "http",
      "url": "https://mcp.ainpcengine.com/mcp",
      "headers": {
        "Authorization": "Bearer ${AINPC_CLI_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=ainpc-cli&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmFpbnBjZW5naW5lLmNvbS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHtBSU5QQ19DTElfVE9LRU59In19"
}
{
  "servers": {
    "ainpc-cli": {
      "type": "http",
      "url": "https://mcp.ainpcengine.com/mcp",
      "headers": {
        "Authorization": "Bearer ${AINPC_CLI_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "ainpc-cli": {
      "httpUrl": "https://mcp.ainpcengine.com/mcp",
      "headers": {
        "Authorization": "Bearer ${AINPC_CLI_TOKEN}"
      }
    }
  }
}
extensions:
  "ainpc-cli":
    enabled: true
    name: "ainpc-cli"
    type: streamable_http
    uri: "https://mcp.ainpcengine.com/mcp"
    headers:
      "Authorization": "Bearer ${AINPC_CLI_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${AINPC_CLI_TOKEN}. The registry never accepts secret values.

Quality 85 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene86 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations2 of 2 tools declare readOnlyHint or destructiveHint
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: ainpc_get_started (idempotentHint); ainpc_signup (idempotentHint)
  • pass
    tools.token_costabout 269 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stabilityn/a · weight 15
  • n/a
    stability.changes, stability.rug_pulltool history recorded for 6 of the 7 days needed
dependencies100 · weight 15
  • pass
    deps.known_vulnsno known advisory in 1 resolved packages
  • n/a
    deps.mcp_sdk_versionthe official MCP SDK is not in the dependency graph
  • pass
    deps.resolvable[email protected] resolved: 1 packages

2 tools, about 269 tokens to load them all · tool set c26747114499 · checked 2026-10-19 15:48 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 67 / 100

provenance90
liveness0
freshness100
hygiene100

+repository +namespace-matches-repo +website -unreachable(4 failures) +updated-26d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] npm0 dependencies, resolved · advisories checked 2026-10-19

No known advisory affects this dependency graph.

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://mcp.ainpcengine.com/mcp streamable-httpnoneno (4 failures)24%753 ms2025-11-252026-10-12
https://mcp.ainpcengine.com/sse sseapi_key ${AINPC_CLI_TOKEN}no (13 failures)0%–––
packageregistryversionruntimesecrets
ainpc-clinpm1.5.4npxAINPC_API_KEY

Tools (2)

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

Schemas: list_tools.

Similar MCP servers

More from io.github.jyswee

And 9 more from this publisher.

Official server.json
{
  "name": "io.github.jyswee/ainpc-cli",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.ainpcengine.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "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."
        }
      ]
    },
    {
      "url": "https://mcp.ainpcengine.com/sse",
      "type": "sse",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "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."
        }
      ]
    }
  ],
  "version": "1.5.4",
  "packages": [
    {
      "version": "1.5.4",
      "transport": {
        "type": "stdio"
      },
      "identifier": "ainpc-cli",
      "runtimeHint": "npx",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "runtimeArguments": [
        {
          "type": "positional",
          "value": "mcp-serve",
          "isRequired": true
        }
      ],
      "environmentVariables": [
        {
          "name": "AINPC_API_KEY",
          "isSecret": true,
          "isRequired": true,
          "description": "AINPCEngine API key (npk_...). Get one with `ainpc signup` — 7-day free trial."
        },
        {
          "name": "AINPC_GAME_ID",
          "description": "Game slug to scope NPC tools to."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/jyswee/ainpc-cli",
    "source": "github"
  },
  "websiteUrl": "https://ainpcengine.com",
  "description": "AI NPCs with persistent memory for game studios. NPC CRUD, dialogue, voice. Stdio or remote SSE."
}