@hypersoniclabs/helix-mcp

The HELIX Instant MCP server — gives AI coding agents the platform contract so they can inspect it, generate a compatible world, validate it, and publish it. Resources expose the docs an agent reads before generating; tools run the same code paths as the human helix CLI (it depends on @hypersoniclabs/helix-cli). Login stays human (helix login once); agents check whoami.

Use it

Add to your MCP client config (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "helix-instant": {
      "command": "npx",
      "args": ["-y", "@hypersoniclabs/helix-mcp@latest"]
    }
  }
}

Point it at a backend with the HELIX_API_URL env var (defaults to localhost); discovery tools work unauthenticated, publishing needs helix login (a client token).

Tools

get_started, read_doc, whoami, validate_world, publish_world, list_my_worlds, list_systems, list_abilities, get_package_manifest, check_for_updates.

Resources

helix://docs/{character-world,world-recipe,sdk,manifest,publishing,catalog} — the agent documentation, served from docs/.

Develop

npm install
npm run build   # tsc → dist/ (bin: dist/server.js)
npm test        # boots the server over stdio and asserts the tools register

This package is intentionally thin: it depends on @hypersoniclabs/helix-cli for all publish/validate/discovery logic, so the CLI and MCP can never drift. The humanoid-character system, its abilities, and asset-packs are authored in helix-web-engine and published to the catalog the agent discovers.