Docs / MCP

DOCS / MCP

Use Seizn memory from your agent runtime

@seizn/mcp exposes NPC memory, Canon Locks, deterministic replay, Chaos Monkey, and Story Health as MCP tools. The server starts over stdio and reads only SEIZN_API_KEY from the process environment.

01

Install

Set SEIZN_API_KEY before the MCP server starts. Do not pass keys in command args or tool arguments. SEIZN_API_URL is optional and defaults to https://www.seizn.com.

export SEIZN_API_KEY=szn_live_xxx
npx -y @seizn/mcp

02

Tools

seizn.memory.search(query, npc_id?)seizn.memory.create(npc_id, content, metadata?)seizn.canon.list(npc_id?)seizn.canon.check(npc_id?, proposed_content)seizn.replay.fetch(session_id)seizn.chaos.run(npc_id, suite)seizn.story_health.current(act?)

03

Client configs

Claude Desktop

{
  "mcpServers": {
    "seizn": {
      "command": "npx",
      "args": ["-y", "@seizn/mcp"],
      "env": {
        "SEIZN_API_KEY": "szn_live_xxx"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "seizn": {
      "command": "npx",
      "args": ["-y", "@seizn/mcp"],
      "env": {
        "SEIZN_API_KEY": "szn_live_xxx"
      }
    }
  }
}

Claude Code

export SEIZN_API_KEY=szn_live_xxx
claude mcp add seizn -- npx -y @seizn/mcp

Codex CLI

[mcp_servers.seizn]
command = "npx"
args = ["-y", "@seizn/mcp"]

[mcp_servers.seizn.env]
SEIZN_API_KEY = "szn_live_xxx"

04

Canon check payload

{
  "tool": "seizn.canon.check",
  "arguments": {
    "npc_id": "archivist_vale",
    "proposed_content": "Vale reveals the sealed city password."
  }
}