Skip to content
Back to search

mcp-npm

Stdio MCP connector for the hosted Spatial Compiler. MIT. No compiler source.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/applied-manifold--mcp-npm/badge.svg)](/listings/applied-manifold--mcp-npm)

HTML

<a href="/listings/applied-manifold--mcp-npm"><img src="/api/listings/applied-manifold--mcp-npm/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You need Node.js 18 or newer and an API key. [Get Free API Key](https://console.appliedmanifold.com)

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](https://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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 137 lines
  1. # Spatial Compiler
  2. Your agent gets fully simulated, engine-ready 3D in seconds, from one call.
  3. 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.
  4. 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.
  5. Use the result in Godot 4 today.
  6. Games are where this starts. The same call also serves robotics, ecommerce, and other 3D work that needs a fully simulated, engine-ready result.
  7. This repository is the npm package [`@applied-manifold/spatial-compiler`](https://www.npmjs.com/package/@applied-manifold/spatial-compiler). It is a small connector that forwards MCP calls to [https://mcp.spatialcompiler.dev](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.
  8. This repository does not include Spatial Compiler or any compiler source.
  9. [Get Free API Key](https://console.appliedmanifold.com)
  10. More about Spatial Compiler: [https://appliedmanifold.com](https://appliedmanifold.com)
  11. ## Install and run
  12. You need Node.js 18 or newer and an API key. [Get Free API Key](https://console.appliedmanifold.com)
  13. ```sh
  14. SPATIAL_API_KEY=YOUR_KEY npx -y @applied-manifold/spatial-compiler
  15. ```
  16. 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.
  17. ### Claude Code
  18. ```sh
  19. claude mcp add spatial-compiler -e SPATIAL_API_KEY=YOUR_KEY -- npx -y @applied-manifold/spatial-compiler
  20. ```
  21. ### Cursor (stdio via npm)
  22. Add this to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):
  23. ```json
  24. {
  25. "mcpServers": {
  26. "spatial-compiler": {
  27. "command": "npx",
  28. "args": ["-y", "@applied-manifold/spatial-compiler"],
  29. "env": {
  30. "SPATIAL_API_KEY": "YOUR_KEY"
  31. }
  32. }
  33. }
  34. }
  35. ```
  36. ### Cursor or any client (hosted MCP, no npm)
  37. ```json
  38. {
  39. "mcpServers": {
  40. "spatial-compiler": {
  41. "url": "https://mcp.spatialcompiler.dev"
  42. }
  43. }
  44. }
  45. ```
  46. The hosted server signs you in through [console.appliedmanifold.com](https://console.appliedmanifold.com) when the client supports OAuth.
  47. ### Codex
  48. Add this to `~/.codex/config.toml`:
  49. ```toml
  50. [mcp_servers.spatial-compiler]
  51. command = "npx"
  52. args = ["-y", "@applied-manifold/spatial-compiler"]
  53. env = { SPATIAL_API_KEY = "YOUR_KEY" }
  54. ```
  55. Or from a terminal:
  56. ```sh
  57. codex mcp add spatial-compiler --env SPATIAL_API_KEY=YOUR_KEY -- npx -y @applied-manifold/spatial-compiler
  58. ```
  59. 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.
  60. ## Sign in without an API key
  61. 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.
  62. If your client cannot open a browser, sign in once from a terminal:
  63. ```sh
  64. npx -y @applied-manifold/spatial-compiler login
  65. ```
  66. To forget the saved session:
  67. ```sh
  68. npx -y @applied-manifold/spatial-compiler logout
  69. ```
  70. ## Environment variables
  71. | Variable | Purpose |
  72. | --- | --- |
  73. | `SPATIAL_API_KEY` | API key (`spck_live_...` or `spck_test_...`). Preferred, matches the public docs. |
  74. | `SPATIAL_COMPILER_API_KEY` | Same, used when `SPATIAL_API_KEY` is not set. |
  75. | `SPATIAL_COMPILER_MCP_URL` | Optional. Hosted MCP URL without a trailing slash. Default `https://mcp.spatialcompiler.dev`. |
  76. With a key set, the server sends `Authorization: Bearer <key>` and does not use the browser sign-in.
  77. Logs go to stderr. stdout carries only the MCP stream.
  78. Run `npx -y @applied-manifold/spatial-compiler --help` for a summary.
  79. ## What the hosted server can do
  80. The hosted server lists `discover`, `add_input`, `estimate`, `submit`, `get_job`, and `cancel_job`. `estimate` is free. `submit` starts a paid job.
  81. 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. After a run, the bundled `verify-compiled-job` skill reads the receipt and inspects a framed still.
  82. ## Links
  83. - Site: [https://appliedmanifold.com](https://appliedmanifold.com)
  84. - Console and API keys: [https://console.appliedmanifold.com](https://console.appliedmanifold.com)
  85. - Hosted MCP: [https://mcp.spatialcompiler.dev](https://mcp.spatialcompiler.dev)
  86. - Agent docs: [https://appliedmanifold.com/docs/agents/](https://appliedmanifold.com/docs/agents/)
  87. - MCP tools docs: [https://appliedmanifold.com/docs/mcp-tools/](https://appliedmanifold.com/docs/mcp-tools/)
  88. - Examples: [https://appliedmanifold.com/modules/pyro/](https://appliedmanifold.com/modules/pyro/)
  89. - Terms: [https://appliedmanifold.com/terms/](https://appliedmanifold.com/terms/)
  90. - Privacy: [https://appliedmanifold.com/privacy/](https://appliedmanifold.com/privacy/)
  91. ## License
  92. MIT. Copyright 10356689 Canada Inc. (Applied Manifold). See [LICENSE](./LICENSE). This package does not include Spatial Compiler or any compiler source.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.