Agents, MCP & CLI

Everything the inbox does goes through one REST API. Claude Code, Cursor, Codex or your own scripts can use it with a scoped key, through the MCP server, the CLI or the skill.

API keys and scopes

An admin creates keys in the inbox under Settings → API keys, one per agent or script, so you can tell them apart in the audit log and revoke one without touching the others. Keys look like ig_sk_… and are shown once.

Use the key as a bearer token:

curl https://app.inngame.app/v1/conversations?status=open \
  -H "Authorization: Bearer $INNGAME_API_KEY"

MCP server

The MCP server is at /mcp and speaks Streamable HTTP (stateless). Authenticate with the API key in the Authorization header. Each tool calls the REST API with that key, so an agent can never do more than its key allows, and every action shows up in the audit log under the key's name. An agent already connected to https://inngame.meffysto.workers.dev/mcp keeps working.

Claude Code

claude mcp add --transport http inngame https://app.inngame.app/mcp \
  --header "Authorization: Bearer $INNGAME_API_KEY"

Cursor

In ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "inngame": {
      "url": "https://app.inngame.app/mcp",
      "headers": { "Authorization": "Bearer ig_sk_..." }
    }
  }
}

Codex

In ~/.codex/config.toml:

[mcp_servers.inngame]
url = "https://app.inngame.app/mcp"
http_headers = { Authorization = "Bearer ig_sk_..." }

npx inngame mcp claude|cursor|codex|json prints these snippets with your saved key filled in.

Tools

CLI

The inngame CLI has no dependencies and needs Node.js 20 or later. Every command maps to the REST API, with the same key and rights as MCP.

npx inngame login ig_sk_...        # saves the key to ~/.config/inngame/config.json
npx inngame whoami
npx inngame inbox --unread

Add --json to any command for raw JSON. Environment variables: INNGAME_API_KEY, INNGAME_URL, INNGAME_CONFIG.

Skill

The Inngame skill teaches a coding agent how to run your support: triage the inbox, answer from the FAQ, handle drafts, triage bugs into GitHub and fix PRs, and install the SDK. It follows the rules below.

• Claude Code: put the inngame skill folder in ~/.claude/skills/inngame. In one command:

  mkdir -p ~/.claude/skills/inngame && curl -fsSL https://inngame.app/skill/inngame/SKILL.md -o ~/.claude/skills/inngame/SKILL.md

• Codex, Cursor, T3 Code, Hermes: point the agent at the skill's SKILL.md.

Download: inngame.zip (the skill folder) or SKILL.md alone.

Then ask things like "check support", "what are players complaining about this week?" or "any new bugs?".

Install in one prompt

inngame init prints a prompt to paste into your coding agent, with your app key filled in when you pass --app:

npx inngame apps                     # find your app id
npx inngame init unity --app app_... # or: init ios, init web

The agent adds the package, configures the SDK at startup, identifies the player when they're known (Steam ticket on Steam builds), adds a Support entry to your pause or settings menu that works with mouse, touch and gamepad, passes useful context, and checks that the project compiles, without touching gameplay code.

Human approval rules

These are enforced by the server, not just suggested to the agent.

Who has the floor. When a teammate replies in a conversation, the built-in AI pauses there (its mode switches to off). Replies sent with an API key don't change the AI mode; set aiMode yourself if your agent should take over or hand back (inherit returns to the app setting).

The built-in AI and BYOK

Each app has an AI mode (Settings → AI): off (default), draft (the AI writes, a human sends) or auto (the AI answers from the FAQ and hands off when unsure). Each conversation can override it with inherit, auto, draft or off. You can pause the AI for a whole app at any time; humans keep answering.

By default the AI and translation run on Cloudflare Workers AI and AI messages count toward your plan (1,000 or 10,000 a month). Bring your own key to remove the cap: an admin picks Anthropic or OpenAI in Settings → AI and pastes a key, which is stored encrypted. Through the API:

curl -X PATCH https://app.inngame.app/v1/org \
  -H "Authorization: Bearer $INNGAME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"aiProvider": "anthropic", "aiKey": "sk-ant-...", "aiModel": null}'

Set aiProvider back to platform to return to the included quota.