Reference MCP Server

Story Machine includes an MCP (Model Context Protocol) server that lets AI tools like Claude inspect and edit the currently open project. When the server is enabled, a connected AI client can open scenes, create and modify game objects, edit components and action sequences, manage variables, lists, and text databases, and capture screenshots of the stage.

Enabling the Server

The MCP server is a local server that is enabled with a per-project setting. Open Project Settings → MCP, turn on Enable MCP Server, and choose a port (the default is 8080).

Connecting a Client

The server speaks the MCP Streamable HTTP transport at:

http://localhost:8080/mcp

(Replace 8080 with your configured port.)

Any MCP client that supports the Streamable HTTP transport (2025-03-26 revision or later) can connect to /mcp directly. Clients that only speak the older HTTP+SSE transport can connect to http://localhost:8080/sse instead.

Claude Code

Register the server once from a terminal:

claude mcp add --transport http storymachine http://localhost:8080/mcp

New Claude Code sessions will connect automatically and list the Story Machine tools. Make sure the Editor is running with your project open before starting a session.

Claude Desktop

Claude Desktop’s local server configuration is set through a json config file. Open Settings → Developer → Edit Config and add the server with the mcp-remote bridge:

{
  "mcpServers": {
    "storymachine": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:8080/mcp", "--allow-http"]
    }
  }
}

This requires Node.js to be installed for npx. See full documentation for setting up local MCP servers on Claude Desktop.

Restart Claude Desktop after editing the config.

ChatGPT

ChatGPT (formerly Codex) shares MCP configuration across its CLI, desktop app, and IDE extension. Register the server once from a terminal:

codex mcp add storymachine --url http://localhost:8080/mcp

Or add it to ~/.codex/config.toml directly:

[mcp_servers.storymachine]
url = "http://localhost:8080/mcp"