Skip to main content
Glama

Spatial Compiler

Your agent gets fully simulated, engine-ready 3D in seconds, from one call.

You write a spec, or your agent does. Spatial Compiler runs a real simulation and sends back effect sheets and assets you can drop into your game. You do not wait for your agent to write simulation or shader code from scratch. That path is slow, fragile, and often looks fake.

You get real simulation quality in seconds, not hours. The same spec gives you the same result. You see the price before you run. It works from any MCP client, including Claude Code, Cursor, and Codex, and over HTTP.

Use the result in Godot 4 today.

Games are where this starts. The same call also serves robotics, ecommerce, and other 3D work that needs a fully simulated, engine-ready result.

This repository is the npm package @applied-manifold/spatial-compiler. It is a small connector that forwards MCP calls to https://mcp.spatialcompiler.dev. You can also point a client at that URL directly. Nothing compiles on your machine. Jobs are billed the same as when you use the hosted server directly.

This repository does not include Spatial Compiler or any compiler source.

Get Free API Key

More about Spatial Compiler: https://appliedmanifold.com

Install and run

You need Node.js 18 or newer and an API key. Get Free API Key

SPATIAL_API_KEY=YOUR_KEY npx -y @applied-manifold/spatial-compiler

Your MCP client normally starts this command for you. Use one of the setups below. If you omit the key, the connector opens a browser sign-in and remembers the session.

Claude Code

claude mcp add spatial-compiler -e SPATIAL_API_KEY=YOUR_KEY -- npx -y @applied-manifold/spatial-compiler

Cursor (stdio via npm)

Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "spatial-compiler": {
      "command": "npx",
      "args": ["-y", "@applied-manifold/spatial-compiler"],
      "env": {
        "SPATIAL_API_KEY": "YOUR_KEY"
      }
    }
  }
}

Cursor or any client (hosted MCP, no npm)

{
  "mcpServers": {
    "spatial-compiler": {
      "url": "https://mcp.spatialcompiler.dev"
    }
  }
}

The hosted server signs you in through console.appliedmanifold.com when the client supports OAuth.

Codex

Add this to ~/.codex/config.toml:

[mcp_servers.spatial-compiler]
command = "npx"
args = ["-y", "@applied-manifold/spatial-compiler"]
env = { SPATIAL_API_KEY = "YOUR_KEY" }

Or from a terminal:

codex mcp add spatial-compiler --env SPATIAL_API_KEY=YOUR_KEY -- npx -y @applied-manifold/spatial-compiler

Any other MCP client that can start a stdio server works the same way: run npx -y @applied-manifold/spatial-compiler with SPATIAL_API_KEY in its environment.

Related MCP server: blender-fx-mcp

Sign in without an API key

If you start the server without a key, it opens a browser sign-in against the hosted service and remembers the session, so later runs start without asking. The session (including the refresh token) is saved in ~/.config/spatial-compiler/mcp-oauth.json (or under $XDG_CONFIG_HOME) with file mode 0600.

If your client cannot open a browser, sign in once from a terminal:

npx -y @applied-manifold/spatial-compiler login

To forget the saved session:

npx -y @applied-manifold/spatial-compiler logout

Environment variables

Variable

Purpose

SPATIAL_API_KEY

API key (spck_live_... or spck_test_...). Preferred, matches the public docs.

SPATIAL_COMPILER_API_KEY

Same, used when SPATIAL_API_KEY is not set.

SPATIAL_COMPILER_MCP_URL

Optional. Hosted MCP URL without a trailing slash. Default https://mcp.spatialcompiler.dev.

With a key set, the server sends Authorization: Bearer <key> and does not use the browser sign-in.

Logs go to stderr. stdout carries only the MCP stream.

Run npx -y @applied-manifold/spatial-compiler --help for a summary.

What the hosted server can do

The hosted server lists discover, add_input, estimate, submit, get_job, and cancel_job. estimate is free. submit starts a paid job.

Ask your agent to write a spec, get a free price estimate, and run a job. You get back fully simulated, engine-ready 3D, plus a report your code can check.

License

MIT. Copyright 10356689 Canada Inc. (Applied Manifold). See LICENSE. This package does not include Spatial Compiler or any compiler source.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers